短信

接口鉴权 参阅《消息接口文档》

创建短信发送任务

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 发送成功