# Tencent Cloud Cloud Automated Testing (Dial Testing) API

> Tencent Cloud Cloud Automated Testing (Dial Testing) API on Apizie: 14 endpoints (Create Probe Tasks, Delete Probe Task, Describe Detailed Single Probe Data, Describe Instant Tasks, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://www.apizie.tech/v1/cloud:tencent-cat/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:tencent-cat`
- Category: Cloud
- Status: byok
- Source: https://www.tencentcloud.com/document/api
- Page: https://www.apizie.tech/api/cloud/tencent-cat
- OpenAPI: https://www.apizie.tech/api/cloud/tencent-cat/openapi.json

Tencent Cloud API 3.0 for Cloud Automated Testing (Dial Testing) (cat). Every call is signed with TC3-HMAC-SHA256 using your SecretId and SecretKey.

## Endpoints

### Create Probe Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-cat/create-probe-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BatchTasks | array | yes |  |
| TaskType | integer | yes |  |
| Nodes | array | yes |  |
| Interval | integer | yes |  |
| Parameters | string | yes |  |
| TaskCategory | integer | yes |  |
| Cron | string | no |  |
| Tag | array | no |  |
| ProbeType | integer | no |  |
| PluginSource | string | no |  |
| ClientNum | string | no |  |
| NodeIpType | integer | no |  |
| SubSyncFlag | integer | no |  |
| RtxName | string | no |  |

### Delete Probe Task
`POST https://www.apizie.tech/v1/cloud:tencent-cat/delete-probe-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TaskIds | array | yes |  |

### Describe Detailed Single Probe Data
`POST https://www.apizie.tech/v1/cloud:tencent-cat/describe-detailed-single-probe-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| BeginTime | integer | yes |  |
| EndTime | integer | yes |  |
| TaskType | string | yes |  |
| SortField | string | yes |  |
| Ascending | boolean | yes |  |
| SelectedFields | array | yes |  |
| Offset | integer | yes |  |
| Limit | integer | yes |  |
| TaskID | array | no |  |
| Operators | array | no |  |
| Districts | array | no |  |
| ErrorTypes | array | no |  |
| City | array | no |  |
| ScrollID | string | no |  |
| QueryFlag | string | no |  |

### Describe Instant Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-cat/describe-instant-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| Limit | integer | yes |  |
| Offset | integer | yes |  |

### Describe Node Groups
`POST https://www.apizie.tech/v1/cloud:tencent-cat/describe-node-groups` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| NodeType | array | no |  |
| TaskCategory | integer | no |  |
| IPType | integer | no |  |
| Name | string | no |  |
| RegionID | integer | no |  |
| DistrictID | integer | no |  |
| NetServiceID | integer | no |  |
| NodeGroupType | integer | no |  |
| TaskType | integer | no |  |
| ProbeType | integer | no |  |

### Describe Nodes
`POST https://www.apizie.tech/v1/cloud:tencent-cat/describe-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| NodeType | integer | no |  |
| Location | integer | no |  |
| IsIPv6 | boolean | no |  |
| NodeName | string | no |  |
| PayMode | integer | no |  |
| TaskType | integer | no |  |

### Describe Probe Metric Data
`POST https://www.apizie.tech/v1/cloud:tencent-cat/describe-probe-metric-data` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AnalyzeTaskType | string | no |  |
| MetricType | string | no |  |
| Field | string | no |  |
| Filter | string | no |  |
| GroupBy | string | no |  |
| Filters | array | no |  |

### Describe Probe Metric Tag Values
`POST https://www.apizie.tech/v1/cloud:tencent-cat/describe-probe-metric-tag-values` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| AnalyzeTaskType | string | no |  |
| Key | string | no |  |
| Filter | string | no |  |
| Filters | array | no |  |
| TimeRange | string | no |  |

### Describe Probe Nodes
`POST https://www.apizie.tech/v1/cloud:tencent-cat/describe-probe-nodes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| NodeType | integer | no |  |
| Location | integer | no |  |
| IsIPv6 | boolean | no |  |
| NodeName | string | no |  |
| PayMode | integer | no |  |

### Describe Probe Tasks
`POST https://www.apizie.tech/v1/cloud:tencent-cat/describe-probe-tasks` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TaskIDs | array | no |  |
| TaskName | string | no |  |
| TargetAddress | string | no |  |
| TaskStatus | array | no |  |
| Offset | integer | no |  |
| Limit | integer | no |  |
| PayMode | integer | no |  |
| OrderState | integer | no |  |
| TaskType | array | no |  |
| TaskCategory | array | no |  |
| OrderBy | string | no |  |
| Ascend | boolean | no |  |
| TagFilters | array | no |  |

### Resume Probe Task
`POST https://www.apizie.tech/v1/cloud:tencent-cat/resume-probe-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TaskIds | array | yes |  |

### Suspend Probe Task
`POST https://www.apizie.tech/v1/cloud:tencent-cat/suspend-probe-task` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TaskIds | array | yes |  |

### Update Probe Task Attributes
`POST https://www.apizie.tech/v1/cloud:tencent-cat/update-probe-task-attributes` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TaskId | string | yes |  |
| Name | string | no |  |

### Update Probe Task Configuration List
`POST https://www.apizie.tech/v1/cloud:tencent-cat/update-probe-task-configuration-list` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| X-TC-Region | string | no | Region for regional products, for example ap-singapore, ap-guangzhou, na-siliconvalley |
| TaskIds | array | yes |  |
| Nodes | array | yes |  |
| Interval | integer | yes |  |
| Parameters | string | yes |  |
| Cron | string | no |  |
| ResourceIDs | array | no |  |
| NodeIpType | integer | no |  |
| BatchTasks | array | no |  |

## Example
```
curl "https://www.apizie.tech/v1/cloud:tencent-cat/create-probe-tasks" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Tencent Cloud Cloud Automated Testing (Dial Testing) API?
Create a free Apizie key, then send POST https://www.apizie.tech/v1/cloud:tencent-cat/create-probe-tasks with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Tencent Cloud Cloud Automated Testing (Dial Testing) API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Tencent Cloud Cloud Automated Testing (Dial Testing) itself also needs your own key from tencentcloudapi.com.

### Can AI agents use the Tencent Cloud Cloud Automated Testing (Dial Testing) API?
Yes. Add the Apizie MCP server (https://www.apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:tencent-cat.

### What is the status of the Tencent Cloud Cloud Automated Testing (Dial Testing) API?
Needs your own provider key (bring your own key)