我名称:天一红短信国际频道接口说明
二,。接口协议:http
三、 编码格式:utf8
四、请求方法:GET、POST
五、Content-Type:application/json;charset=UTF-8
六、Sign签名生成方法:将账号、API秘钥、请求时间拼成字符串,做MD5加密,MD5使用32位小写
示例:
参数:account:testpassword:123456datetime:20190101120000
方法:MD5(test12345620190101120000)
Sign:6ac4928d8d0c3c5ba75981b539c52152
注:API秘钥(password)为认证秘钥,非登录密码,可登录天一泓短信系统查询获取;请求时间(datetime)需传GMT+8当前半小时内时间,格式为年月日时分秒,而非时间戳。
天一泓短信国际通道接口
一、账号错误:{“status”:-1,”desc”:”user not exist”}
原因分析:
1) 发送短信接口传入的账号错误,需核对账号是否正确。
2) POST提交未将account、sign、datetime放至URL中。
二、认证错误:{“status”:-1,”desc”:”auth failed”}
原因分析:
1) 发送短信接口传入的密码错误,需核对密码是否正确,密码为认证秘钥,非登录密码,认证秘钥需登录天一泓短信系统获取。
2) 发送接口中传入的sign参数中使用的datetime与接口传入的datetime不一致。
三、时间过期:{“status”:-1,”desc”:”timestamp expires”}
原因分析:发送短信接口传入的datetime过期,datetime需使用GMT+8当前半小时内的时间,且时间格式是年月日时分秒,非时间戳,如请求服务器非GMT+8时区,注意需作时间转换。
四、号码错误:{“status”:-9}
原因分析:发送接口传入的号码错误,常见原因如下:
1) 接收号码未加国家码或国家码后面加了0,天一泓系统要求传入的号码为加上国家码的完整国际号码,正确示例:6281211111111,错误示例:81211111111、081211111111、62081211111111。
2) 接收号码未在商务合作范围内,例如商务只合作印尼,那此账户仅能发送印尼号码,其他国家号码会返回-9。
3) 接收号码在商务合作范围,且号码格式无误,那么此号码的号段未在天一泓系统的号段允许中,请确认号码是否存在,如确认存在,可联系天一泓商务添加。
五、频率限制:{“status”:-15,”desc”:”Frequent Queries “}
原因分析:getsentrcd接口查询频率超过限制,查询频率最高允许每分钟1次查询,需控制查询频率在允许范围内。