1 协议说明
名称 | 说明 |
协议 | HTTP POST |
编码格式 | UTF8 |
Content-Type | application/json |
URL | http://xxx/msg/send/json 或者 https://xxx/msg/send/json |
接口说明 | 此接口一次可提交不超过1000个手机号码。 |
2 请求包体
包体为json字符串，参数如下：
{
"account" : "N6000001", //用户在253云通讯平台上申请的API账号
"password" : "123456", //用户在253云通讯平台上申请的API账号对应的API密钥
"msg" : "【253】您的验证码是：2530", //短信内容。长度不能超过536个字符
"phone" : "15800000000", //手机号码。多个手机号码使用英文逗号分隔
"sendtime" : "201704101400", //定时发送短信时间。格式为yyyyMMddHHmm，值小于或等于当前时间则立即发送，不填则默认为立即发送（选填参数）
"report" : "true", //是否需要状态报告（默认为false）（选填参数）
"extend" : "555", //用户自定义扩展码，纯数字，建议1-3位（选填参数）
"uid" : "批次编号-场景名（英文或者拼音）" //自助通系统内使用UID判断短信使用的场景类型，可重复使用，可自定义场景名称，示例如 VerificationCode（选填参数）
}
注：发送短信的账号不是253平台登录账号，是短信接口API账号 。
1. 发送的短信内容一定要加上签名，账号有报备过签名的可不用带上签名， 但如果您有多个短信签名，请将需要的短信签名放在短信内容前面 。
例如您有”【253云通讯】”，”【通讯云】”两个签名，但是想以”【通讯云】”签名发送短信，则”msg”字段可赋值为：”【通讯云】你的验证码是xxxx”，不填默认第一个签名。
2.
用户自定义扩展码，发送短信显示号码，规则为：10690+xxx（通道号）+xxx(系统扩展码) +xxx（用户自定义扩展码）；扩展码的长度将直接影响短信上行接收的接收。如需要传扩展码参数时，请咨询客服相关设置问题 。
3 应答包体
{
"code" : "0", //状态码
"msgId" : "17041010383624511", //消息Id
"errorMsg" : "", //失败状态码说明（成功返回空）
"time" : "20170410103836" //响应时间
}
注：code为响应状态码，可以和“响应状态码”进入对比