智能短信

1、智能短信发送

请求头Content-Type：application/x-www-form-urlencoded
请求方式：POST 返回值：JSON

备注：黑名单等拦截错误实时返回，一次最多提交一万条

地址：https://api.3yit.com/api/send-aim

参数

结果

2、获取报告状态

请求头Content-Type：application/x-www-form-urlencoded
请求方式：GET  返回值：JSON

备注：每条短信状态仅可获取一次，运营商返回某条短信状态后，此接口就能拉取到，之后调用此接口将不会返回此条短信的状态，所以调用者拉到数据后需要根据 手机号+msg_id 将状态存在本地

地址：https://api.3yit.com/api/report

参数

返回值

4、获取用户上行回复

请求方式：GET 返回值：JSON

备注：比如退订等，每条短信状态仅可获取一次，手机回复上行后，此接口就能拉取到上行数据，每个上行数据只能拉取到一次，所以调用者拉到上行后，需要将上行的内容存在本地，然后自行根据 msg_id,手机号 等信息匹配具体哪条短信产生的上行回复

地址：https://api.3yit.com/api/get-reply

参数

返回值

7、错误码

发送错误码

状态发送

8、签名生成规则

第一步：准备QueryString

1、将所有参数（除了signature）按照key排序（顺序）

2、将排序好的参数key和值进行URLEncode，之后再增加三种字符替换：加号（+）替换成 %20、星号（*）替换成 %2A、%7E 替换回波浪号（~）

3、将格式化后的key和值按照key + "=" + 值进行拼接成字符串QueryString，多个参数间用&连接，例：”a=%E5%93%88%E5%93%88&b=haha”

4、在上一步得到的QueryString前拼接上请求方式，生成新的QueryString，HTTPMethod + "&" + URLEncode("/") + "&" + QueryString

第二步：准备signature

1、将上面得到的QueryString进行HmacSHA1算法进行编码，HMAC生成信息摘时需要用您的产品密码作为密钥。

2、之后将上面加编码后的字符串进行base64编码，得到签名signature

3、状态报告推送

每条仅推送一次

注意事项：

推送的是utf8原始字节流

推送格式：

扩展号,调用发送接口返回的msg_id,手机号,状态,时间,售价 字段以,分隔 多条记录以|分隔

内容示范：

123,2,1762532xxxx,DELIVRD,2021-12-23 01:02:03,0.2|123,2,17862532xxxx,DELIVRD,2021-12-23 01:02:03,0.1

5、推送用户上行回复

每条上行回复仅推送一次

注意事项：

推送的是utf8原始字节流

推送格式：

urlencode后的内容,手机号,扩展号,时间 字段以,分隔多条记录以|分隔

内容示范：

TD,158114xxxx,048842426601,20220325123304|退订,1891456xxxx,0615,20211115173903

6、获取余额

请求方式：GET 返回值：JSON

https://api.3yit.com/api/balance

参数

返回值