批量发送短信接口
典型场景
三方平台应用调用物联网卡批量短信发送接口，并返回是否发送成功状态。
接口功能
物联网卡批量短信发送接口。
变更记录
|
接口版本 |
更新时间 |
更新人 |
更新说明 |
|---|---|---|---|
1.0.0 |
2021-03-12 |
缪勇 |
新增物联网卡批量短信发送接口 |
接口原型
|
请求类型 |
POST |
|---|---|
|
请求地址 |
https://api.tibiot.com/api/v1/card/batchSendSms |
|
传输协议 |
HTTP |
|
Content-Type |
application/json |
|
接口说明 |
卡批量短信发送接口，同一IP一秒只能提交一次,一次最大提交100号码 |
请求参数
|
参数 |
是否必填 |
类型 |
示例 |
描述 |
|---|---|---|---|---|
|
userName |
是 |
String |
zhangsan |
用户名 |
|
passWord |
是 |
String |
123456 |
加密后密码,加密规则参照 密码加密规则 |
|
tKey |
是 |
String |
20210312143828 |
当前时间,tKey生成规则参照 tKey规则 |
|
iccids |
是，注：iccids与msisdns(卡号)有且只能有一个 |
String |
89860492192079708955, |
最多提交100个，以英文逗号连接和结尾 |
|
msisdns |
String |
1440926959761,1440926959765, |
||
|
content |
是，注：content与templateId有且只能有一个 |
String |
发送内容（最好不要包含空格和回车）编码要求参照编码需求 |
|
|
templateId |
String |
e8ab298a88054677b78f4eb905fb753f |
模板ID,从平台管理功能中查看 |
|
|
sendCode |
否 |
String |
25 |
字符编码 0 - ASCII 15 - GBK 25 - UCS2 25 - UCS2 （默认） |
请求示例
响应示例
成功：
失败：
响应参数
|
参数 |
类型 |
示例 |
描述 |
|
|---|---|---|---|---|
status |
int |
0 |
返回状态,0：表示系统接收成功，否为失败 |
|
message |
String |
成功 |
返回信息 |
|
data |
submitState |
String |
0 |
返回状态,0：表示设备接收成功，否为失败 |
number |
String |
1440926959761 |
提交的发送号码 |
|
messageId |
String |
2021031217522669865 |
提交返回唯一消息标识 |
|
remark |
String |
提交成功 |
返回提交说明 |
|
