接口说明

• 一、名称：天一泓国际短信IMFS接口说明
• 二、接口协议：HTTP
• 三、编码格式：UTF8
• 四、请求方法：GET、POST
• 五、Content-Type：application/json;charset=UTF-8
• 六、Sign签名生成方法：将账号、API秘钥、请求时间拼成字符串，做MD5加密，MD5使用32位小写
• 示例：

• 注：API秘钥(password)为认证秘钥，非登录密码，可登录天一泓短信系统查询获取；请求时间(datetime)需传GMT+8当前半小时内时间，格式为年月日时分秒，而非时间戳。

余额查询

• 一、接口名称：getbalanceV2
• 二、接口说明：本接口用于查询账户余额信息
• 三、请求方法：GET
• 四、调用方式：http://sms.skylinelabs.cc:20003/getbalanceV2?account=***&sign=***&datetime=***
• 五、请求参数说明：

• 六、接口返回示例：{"status":0,"balance":"99.990000", "gift":"50.00000"}
• 七、返回参数说明：

群发短信

• 一、接口名称：sendsmsV2
• 二、接口说明：本接口用于发送短信，可单条发送，也可批量号码发送同一内容，支持GET、POST方式提交
• 三、请求方法：GET、POST
• 四、调用方式1(GET)：
• URL：http://sms.skylinelabs.cc:20003/sendsmsV2?account=***&sign=***&datetime=***&senderid=***&numbers=8613611111111,8613722222222&content=***
• 五、调用方式2(POST)：
• URL：http://sms.skylinelabs.cc:20003/sendsmsV2?account=***&sign=***&datetime=***
• POST请求使用json格式，参数如下：
• {"content":"test","numbers":"8613611111111,8613722222222","senderid":"123 123"}
• 注：POST请求account、sign、datetime参数需放在URL中，不可放在json中提交
• 六、请求参数说明：

• 七、接口返回示例：
• {"status":0, "success":2, "fail":0, "array":[[8613611111111,1901281451030204206], [8613722222222,1901281450470121055]]}
• 八、返回参数说明：

批量群发短信

• 一、接口名称：batchsendsmsV2
• 二、接口说明：本接口用于批量发送短信，支持不同号码发送不同内容
• 三、请求方法：POST
• 四、调用方式：
• POST /batchsendsmsV2?account=***&sign=***&datetime=**** HTTP/1.1
• Host: http://sms.skylinelabs.cc:20003
• Content-Type:application/json
• {"messages":[{"senderid":"0123456789","content":"%E5%85%BB%E8%80%81%E9%87%91%E8%","mobile":["8613611111111","8613722222222"],"smsid":"1"},{"content":"%E5%86%BB%E8%80%81%E9%87%91%E8%","mobile":["8613811111111"],"smsid":"2"}]}
• 注：POST请求account、sign、datetime参数需放在URL中，不可放在json中提交
• 五、请求参数说明：

• 六、接口返回示例：
• {"success": 1,"fail": 2,"array": [[0,"8613611111111","1",1901121607180200001],[9,"13722222222","1"],[9,"13811111111","2"]]}
• 七、返回参数说明：

短信报告查询

• 一、接口名称：getreportV2
• 二、接口说明：本接口用于查询短信发送报告
• 三、请求方法：GET
• 四、调用方式：
• http://sms.skylinelabs.cc:20003/getreportV2?account=***&sign=***&datetime=***&ids=1901281451030204206,1901281450470121055
• 五、请求参数说明：

• 六、接口返回示例：
• {"status":0, "success":1, "fail":1, "unsent":0, "sending":0, "nofound":0,"array":[[1901281451030204206,"86136****1111",20190128145103,0], [1901281450470121055,"8613722222222",20190128145047,3]]}
• 七、返回参数说明：

批量报告查询

• 一、接口名称：getsentrcdV2
• 二、接口说明：本接口用于批量查询短信发送状态，查询开始时间到结束时间这个时间段内已发送完成的短信报告结果，查询频率最高允许每分钟1次查询，如超过频率，接口将返回-15。
• 三、请求方法：GET
• 四、调用方式：
• http://sms.skylinelabs.cc:20003/getsentrcdV2?account=***&sign=***&datetime=***&date=***&begintime=***&endtime=***&startindex=***
• 四、请求参数说明：

• 五、接口返回示例：
• {"status":0, "totalcnt":2, "retcnt":2, "success":1, "fail":1,"array":[[1902010000230228223,"86136****1111",1548950424,0], [1902010000470228227,"8613722222222",1548950448,3]]}
• 六、返回参数说明：

状态报告推送

• 一、接口说明：本接口主动推送短信状态报告至发送方，短信发送完成时后，系统主动推送状态报告至发送方服务器，发送方需提供接受接口的URL，并在接收到推送后回复200 OK响应
• 二、推送方式：POST
• 三、推送消息JSON格式：
• Content-Type:application/json
• { "msgid":1903121607180200001, "mobile":"8613611111111", "status":0, "timestamp":1565222888000 }
• 四、参数说明：

常见问题分析

• 一、账号错误：{"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次查询，需控制查询频率在允许范围内。