提交短信发送任务
提交国际文本短信发送请求,单接口双鉴权(Bearer API Key / CheckSum)。
提交短信发送任务
curl -X POST "https://api.innosms.com/intsms/v2/om/sms/submit" \
-H "Authorization: Bearer <YOUR_API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"sender": "INNOTEST",
"tdFlag": 1,
"message": "Flash sale today only, up to 50 percent off",
"productType": "market",
"phoneNumbers": "+6591234567,+6591234568,+6591234569",
"validityPeriod": "+000001000000000R"
}'受理处理完成;HTTP 状态码恒为 200,通过业务码区分受理成功与失败。
{
"msg": "success",
"code": "000000",
"data": {
"messageId": "ORDER-20261112-0002",
"errorPhone": [
"+6591234568"
]
},
"requestId": "REQ-20261112-0002"
}来自当前规范的响应示例,不是真实请求结果。
异步受理一条国际文本短信,收件号码 1 到多个。支持 Bearer API Key 或 CheckSum 两种鉴权方式;需配置 apiKey 级 IP 白名单且客户端 IP 匹配。HTTP 状态码恒为 200,业务结果通过六位 code 区分,000000 表示受理成功。
使用 InnoPaaS AppKey 作为 Bearer Token。可在 Console 的 API 密钥页面创建或管理密钥。 查看密钥指南
授权
Authorizationstring<bearer>必填请求头参数
X-Custom-TraceIdstring可选Optional customer trace ID. When provided it is echoed back in the response header and used as the request identifier.
256请求主体
application/jsonuidstring可选客户消息 ID,选填,最长 128 位;批量提交时作为 data.messageId 回显。
128senderstring可选接入号(发件人 ID),选填,最长 20 位。
20tdFlaginteger可选退订标识,选填;1 开启,0 或不传关闭。
messagestring必填短信内容,必填,最长 3000 字符。
3000accountNamestring可选账户名称,选填;不传时默认使用 API Key 关联的账户。
callbackUrlstring可选状态报告回调地址,选填。
productTypestring必填产品类型,必填。notify=验证码/通知短信,market=营销短信;大小写不敏感,非 market 一律按 notify 处理。
phoneNumbersstring必填收件手机号,必填,国际格式(国家码+号码),多个以英文逗号分隔。
validityPeriodstring可选短信有效期,选填,相对时间格式 [+-]YYMMDDhhmmss000R。
响应
application/json受理处理完成;HTTP 状态码恒为 200,通过业务码区分受理成功与失败。
msgstring可选结果说明(英文)。
codestring可选六位业务码,000000 表示受理成功。
dataobjectnull可选受理数据;空值字段不会出现在 JSON 响应体中。
requestIdstring可选本次请求标识;请求携带 X-Custom-TraceId 时原样回显。
{
"msg": "success",
"code": "000000",
"data": {
"messageId": "ORDER-20261112-0002",
"errorPhone": [
"+6591234568"
]
},
"requestId": "REQ-20261112-0002"
}来自当前规范的响应示例,不是真实请求结果。