AIP接口
Api Interface
用户通过HTTP的POST方式提交短信发送请求。编码采用UTF-8编码。
序号 | 参数 | 说明 |
---|---|---|
1 | account | (必填参数)用户账号 |
2 | password | (必填参数)接口密码:web平台中的接口密码 |
3 | content | (必填参数)发送内容,需要进行UTF-8编码,建议每次1000个 格式:格式:内容!@!号码!@@!内容!@!号码,例如content=内容1!@!13566677777!@@!内容2!@!18655555555 |
4 | sendTime | 可选参数。发送时间,填写时按照此时间发送,不填时为当前时间发送(格式:yyyy-MM-dd HH:mm:ss) |
5 | productId | (必填参数)产品编码 |
用户短信通过http请求提交到服务器后,服务器返回响应码,响应码的格式如下:
result: {
"ok": true,
"message": "ok",
"result": {
"blackCount": 1, // 黑名单号码数
"batchNo": "201908261135000000465", // 批次号
"balance": 2, // 余额
"normalCount": 1, // 正常号码数
"unidentifiedCount": 0, // 不能识别运营商号码数
} }
1.1.1 格式说明
短信提交后的响应结果为JSON串数据,ok为true时表示提交成功,为false时表示提交失败,message为具体原因。接口方式提交建议每次请求提交的号码量不超过两万, 请求成功后服务端成功接收到该批号码和内容信息,并返回一个唯一批次号,当用户提交失败时,ok为false,服务端无批次号信息返回。
1.1.2响应状态值说明
参数 | 说明 |
---|---|
ok | true 表示接收成功;false 表示接收失败 |
message | 服务端接收成功时为OK,接收失败时为具体失败原因 |
blackCount | 黑名单号码数 |
batchNo | 批次号,每次请求成功接口都会返回一 个唯一的批次号 |
balance | 此产品的余额 |
unidentifiedCount | 不能识别运营商号码数 |
normalCount | 正常号码数量 |