发送短信 API
合一云
共 2165字,需浏览 5分钟
· 2023-04-19
使用该接口发送文本短信至一个或多个收件人。阅读本文档前请先阅读 API 通用说明。
接口定义
- 接口名:
sms.message.send
- HTTP Method:
POST
- Content-Type:
application/json
请求参数 (Body)
参数名 | 类型 | 是否必填 | 描述 | 示例值 |
---|---|---|---|---|
to | string | string[] | 是 | 收件手机号,国际手机号使用 E.164 格式 | 18688061234 |
signature | string | 是 | 短信签名,2-16 个字符 | 合一短信 |
content | string | 否 | 短信正文文本,templateId 或content 二选一 | 您的验证码是9153,15分钟内有效。 |
templateId | string | 否 | 短信模板 ID 或自定义模板码,templateId 或content 二选一 | login_notify |
templateData | JSON | 否 | 模板变量 | {"code": "9153", "ttl": "15"} |
* 注:为帮助开发者快速迁移,UniSMS支持使用 content 参数直接传入文本,新接入用户建议优先使用 templateId 传参
请求示例
curl -X POST 'https://uni.apistd.com/?action=sms.message.send&accessKeyId=YOUR_ACCESS_KEY_ID' \
-H 'Content-Type: application/json' \
-d '{
"to": "1860571xxxx",
"signature": "合一短信",
"templateId": "signup",
"templateData": {"code": "3241", "ttl": "10"}
}'
响应参数 (Body)
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
code | string | 返回码 | 105400 |
message | string | 返回信息 | InsufficientFunds |
data | JSON | 返回结果 |
返回结果 (data)
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
status | string | 发送状态 | sent |
recipients | integer | 收件人个数 | 1 |
messageCount | integer | 计费消息总条数 | 1 |
totalAmount | number | 总消费金额 | 0.045 |
payAmount | number | 支付消费金额 | 0.045 |
virtualAmount | number | 虚拟消费金额 | 0 |
messages | JSON[] | 发送消息报告 |
发送消息报告 (data.messages)
参数名 | 类型 | 描述 | 示例值 |
---|---|---|---|
id | string | 消息标识 | 7cf4b5c12c5ad49379ce07290d9b00bb |
to | string | 收件人手机号 (E.164) | +8618688061234 |
regionCode | string | 国际代码 | CN |
countryCode | string | 国际电话区号 | 86 |
messageCount | integer | 计费消息总条数 | 1 |
status | string | 发送状态 | sent |
upstream | string | 短信上游 | emay.standard |
price | string | 消费金额 | 0.040000 |
响应示例
成功响应示例
Status Code: 200
, Response Body:
{
"code": "0",
"message": "Success",
"data": {
"recipients": 2,
"messageCount": 2,
"totalAmount": "0.187500",
"payAmount": "0.187500",
"virtualAmount": "0",
"messages": [
{
"id": "4e88293e50aac21d027a9d6c0f33661e",
"to": "+8618688061234",
"regionCode": "CN",
"countryCode": "86",
"messageCount": 1,
"status": "sent",
"upstream": "emay.standard",
"price": "0.050000"
},
{
"id": "ce02a6c4195c6f8c4b6a7250ccb3b0a1",
"to": "+12894260331",
"regionCode": "CA",
"countryCode": "1",
"messageCount": 1,
"status": "sent",
"upstream": "emay.intl.standard",
"price": "0.137500"
}
]
}
}
失败响应示例
Status Code: 400
, Response Body:
{
"code": "105400",
"message": "InsufficientFunds"
}
评论
【106三网短信发送】短信验证码接口-验证码短信API接口-短信接口-短信平台(免费试用)
互亿无线-专业106短信平台,提供短信验证码api接口,验证类短信调用,触发短信对接。让APP、网站、小程序快速实现新用户短信注册、会员短信登录、找回密码短信验证、手机绑定短信认证、支付认证短信等验证码短信功能,短信3秒送达,99%到达率。支持全国移动、联通、电信、虚拟运营商短信发送,专注短信16年,7x24小时技术服务。
上海思锐
0
【106三网短信接口】短信通知接口-通知短信API接口-会员短信提醒-短信发送接口(免费试用)
互亿无线-专业106短信平台,提供短信通知api接口对接,通知类短信调用。让网站/APP/小程序/电商平台快速实现订单通知、支付通知、物流通知、会议通知、报警通知等短信通知功能,短信5秒送达,99%到达率。支持全国移动、联通、电信、虚拟运营商短信发送,专注短信16年,7x24小时技术服务。
上海思锐
0
Miaodisms短信发送模块
基于giiwa和秒嘀的短信发送模块。下载giiwa http://giiwa.org。实现了giiwa的Sms.ISender接口,在giiwa中的其他应用模块可以直接调用giiwa框架的Sms.se
Miaodisms短信发送模块
0
sms-integration短信发送框架
sms-integration 是一个基于SMGP3.4协议、CMPP协议的短信发送框架。特性 支持SMGP3.4协议、CMPP协议依赖<dependency><groupId>
sms-integration短信发送框架
0
Selma短信发送插件
Selma是FireFox浏览器和Thunderbird邮件客户端软件上一个用来发送短信的扩展,不能是通过国外一些网站来提供服务的,目前支持的网站有:-Innosend.de-SMS77.de-sms
Selma短信发送插件
0