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

一、名称：天一泓短信国际通道接口说明

二、接口协议：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不一致。

3) http协议未启用，可登陆天一泓短信系统，我的设置-API设置 中启用。

三、时间过期：{“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次查询，需控制查询频率在允许范围内。