SMS-API接口V3.0

发送消息

请求接口地址

POST    https://api.innopaas.com/api/sms/v3/msg/send

请求参数

字段	数据类型	是否必填	描述
mobile	String	是	手机号码，格式(区号+手机号码)，例如：8615800000000，其中 86 为中国的区号，区号前不使用 00 开头，15800000000 为接收短信的真实手机号码。5-20 位 支持多个，多个以英文都好间隔
msg	String	是	短信内容，长度不能超过 2000 个字符
senderId	String	否	用户收到短信之后显示的发件人，国内不支持自定义，国外支持，但是需要提前和运营商沟通注册，具体请与 TIG 对接人员确定
uid	String	否	客户自定义批次号，64 字以内
callBackUrl	String	否	状态回执的回调地址，请传入完整带http协议头开头的地址，不传默认为空，请勿传入空格，否则会造成地址推送错误。地址可通过接口入参传入，也可在控制台手动配置，

请求示例（验证码）

{
  "msg": "ongratulations! Your application has been approved. ",
  "mobile": "13800138000,13900139000",
  "senderId": "10690000",
  "uid": "ORDER_20251104_001",
  "callBackUrl": "https://api.example.com/callback/sms"
}

响应示例

{
    "code": "0",
    "message": "提交成功",
    "data": {
        "messageId": "162575412960104448"
    }
}

状态报告

待补充

错误码

接口响应码

状态码	描述
0	提交成功
101	账号不存在
102	密码错误
103	拉取条数格式错误
104	拉取条数不在范围内
105	批次编号大于128位
106	短信内容长度错误(>3000)
108	手机号码格式错误(>20或<5)
109	手机号码个数错误
112	产品配置错误
114	请求ip和绑定ip不一致
115	没有开通国内短信权限
116	账号已删除或禁用
117	接入号长度超过20位
119	账号不在当前节点
123	短信内容不能为空
124	简介或验证码不能为空
125	特定客户手机号码同一天不能超过十次
128	账号长度错误(>50或<=0)
129	产品价格配置错误
130	未知异常
131	超过日发送上限
132	超过月发送上限
133	超过发送上限
134	超过反投诉限制
150	子账号依附计费配置有误
151	报价国家未开启
152	产品账号报价不存在
153	依附计费的主账号不存在
154	产品账号计费方式不存在
155	账户未开通统一计费
156	产品账号已禁用
157	账户余额不足
158	授信额度不足
159	客户未开通统一钱包

状态报告错误码

状态码	描述
DELIVRD	短信发送成功
UNKNOWN	未知短信状态
REJECTD	短信被短信中心拒绝
MBBLACK	目的号码是黑名单号码
SM11	网关验证号码格式错误
SM12	我方验证号码格式错误
其他	网关内部状态

计费规则说明

1. 国际短信不支持 emoji 表情

2. 编辑器中空格都会以”."表示，如出现不带”.”的空格则说明有隐藏代码，会导致 1 条短信算成 2 条的风险请留意。

3. 国际号码必须添加对应国家的区域号，例如中国号码 86138****1234，86 为中国区号。

4. 发送中国号码殷时，短信内容必须以[签名]开头，然名内容为: 公司或品牌名称，字数要求 2-80 个字符，运营商规定必填。

5. 发送中国号码段时，内容合法，不能发送房产、发票、移民等国家法律法规严格禁止的内容。

6. 超链接地址请写在短信内容中，便于核实，部分安卓系统存在超链接识别问题，需在超链接前后添加空格。

7. 短信中含非英文字符按中文计费。