# 短信
接口鉴权 参阅《消息接口文档》
# 创建短信发送任务
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 | 发送成功 |