天一泓短信国际频道接口文档

我名称:天一红短信国际频道接口说明

二,。接口协议: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次查询,需控制查询频率在允许范围内。

资源下载: