短信
查询短信任务状态
批量查询短信任务发送状态。taskIdList 不能为空且不超过 100 个。短信服务需已注册并开启。
请求参数
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| appKey | string | 是 | 应用 AppKey | |
| time | int64 | 是 | 请求时间戳(秒) | |
| checksum | string | 是 | 请求签名校验和 | |
| checksumAlgorithm | int32 | 否 | 签名算法:0 - 默认(SHA1),1 - SHA256 |
请求体
| 名称 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| taskIdList | int64[] | 是 | 任务 ID 列表,不能为空且不超过 100 个 | ["123456","123457"] |
返回参数
| 名称 | 类型 | 描述 | 示例值 |
|---|---|---|---|
| code | int32 | 状态码,200 表示成功 | 200 |
| message | object[] | 任务状态列表 | |
| └taskId | int64 | 任务 ID | 123456 |
| └status | int32 | 任务状态,1-发送中 2-已完成 | 1 |
错误码
| 状态码 | 描述 |
|---|---|
| 14001 | AppKey 不存在 |
| 14002 | checksum 校验失败 |
| 14003 | 请求时间戳与服务器时间误差超过 10 分钟 |
| 14004 | 请求体为空或 JSON 格式错误 |
| 14500 | 服务内部异常 |
| 67406 | taskIdList 为空 |
| 67407 | 短信服务未开启或未注册 |
| 67506 | taskIdList 大小超过 100 |
postEndpoint
/openapi/smstask/statuscurl -X POST "https://qiyukf.com/openapi/smstask/status?appKey=string&time=0&checksum=string" \ -H "Content-Type: application/json" \ -d '{ "taskIdList": [ "123456", "123457" ] }'{
"code": 200,
"message": [
{
"taskId": 123456,
"status": 1
}
]
}{
"code": 14001,
"message": "AppKey 不存在"
}{
"code": 14002,
"message": "checksum 校验失败"
}{
"code": 14003,
"message": "请求时间戳与服务器时间误差超过 10 分钟"
}{
"code": 14004,
"message": "请求体为空或 JSON 格式错误"
}{
"code": 14500,
"message": "服务内部异常"
}{
"code": 67406,
"message": "taskIdList 为空"
}{
"code": 67407,
"message": "短信服务未开启或未注册"
}{
"code": 67506,
"message": "taskIdList 大小超过 100"
}这篇文档有帮助吗?