# 短信
接口鉴权 参阅《消息接口文档》
# 创建短信发送任务
POST 请求：
https://qiyukf.com/openapi/smstask/create?appKey=[APP_KEY]&time=[TIME]&checksum=[CHECKSUM]
Content-Type:application/json;charset=utf-8
请求内容如下:
{
"templateId":123, // 短信模板id 必传 http://[code].qiyukf.com/pigeon/settings/ 处查看模板id
"mobileList":["18333333333","18888888888"], // 手机号 必传 最多20个
"params":["abc","xyz","ijk"] // 模板对应的参数 非必传 每个参数最大长度不能超过30字符
}
返回值说明:
{
"code":200,
"message":"12321" // 若返回值code等于200 则此字段为本次任务id
}
code非200的情况
| code | 参数说明 |
|---|---|
| 14001 | appKey不存在 |
| 14002 | checkSum不正确 |
| 14003 | 鉴权时间戳不正确 |
| 14004 | 接口参数缺失 |
| 14500 | 服务器内部错误 |
| 67406 | 模板id或手机号参数不正确 |
| 67407 | 企业短信服务未开通 |
| 67408 | 手机号个数不正确 |
| 67501 | 手机号格式不正确 |
| 67502 | 模板参数长度不正确 |
| 600 | 查看Message描述 |
# 获取短信任务状态
POST 请求：
https://qiyukf.com/openapi/smstask/status?appKey=[APP_KEY]&time=[TIME]&checksum=[CHECKSUM]
Content-Type:application/json;charset=utf-8
请求内容如下:
{
"taskIdList":[123,456,789091] // 短信任务 必传 不能超过100个
}
返回值说明:
{
"code":200,
"message":"{}"
}
code非200的情况
| code | 参数说明 |
|---|---|
| 14001 | appKey不存在 |
| 14002 | checkSum不正确 |
| 14003 | 鉴权时间戳不正确 |
| 14004 | 接口参数缺失 |
| 14500 | 服务器内部错误 |
| 600 | 查看Message描述 |
| 67406 | 参数缺失 |
| 67407 | 企业短信服务未开通 |
| 67506 | 参数个数限制 |
message对象说明： 结构如下：
[
{
"taskId":11, // 任务id
"status":100 // 该任务当前状态
},
{
// ...
}
]
状态说明如下
| status | 参数说明 |
|---|---|
| -100 | 任务发送失败 |
| -99 | 模板或签名审核未通过 |
| -98 | 发送失败 |
| -97 | 发送失败 |
| -96 | 最大条数限制 |
| -95 | 发送失败 |
| -94 | 手机号格式错误 |
| -93 | 余额不足 |
| -92 | 模板或签名类型不匹配 |
| -91 | 发送失败 |
| status>0 && status < 100 | 发送中 |
| 150 | 发送成功 |