SUBMAIL短信平台API接口-Message/send

API: Message/send

原文链接

概览

message/send 是 SUBMAIL 的短信 API。 message/send API 提供强大的短信发送功能, 并允许用户自定义短信签名及正文，无需提前创建模板，SUBMAIL 会根据您提交的短信签名和内容，自动创建模板并发送。

URL

`<主> https://api.mysubmail.com/message/send`

`<备> https://api.submail.cn/message/send`

支持格式

格式	URL
`json`	`https://api.mysubmail.com/message/send.json`（默认）
`xml`	`https://api.mysubmail.com/message/send.xml`

http 请求方式

请求方式	content-type设置
`http post`	`multipart/form-data、x-www-form-urlencoded、application/json`

是否需要授权

是

参阅 API 授权和验证机制

请求参数

参数	类型	必需/可选	默认	描述
`appid`	`string`	`必需`	无	在 SUBMAIL 应用集成中创建的短信应用ID
`to`	`string`	`必需`	无	收件人手机号码，该API仅支持一对一模式（即单条API请求仅能发送一个联系人），该参数现在仅能提交一个位联系人。
`content`	`string`	`必需`	无	短信正文（正文中必须提交有效的短信签名，且您的短信签名必须放在短信的最前端，e.g.【SUBMAIL】您的短信验证码：4438，请在10分钟内输入。 `content`参数将会与您账户中的短信模板进行匹配，如无匹配 API会创建一个短信模板并提交到人工审核，审核通过后下次提交相似短信（内容达到一定匹配度）则不会触发人工审核直接进行下发，如审核失败则第二次请求返回 420 错误，审核失败会触发SUBHOOK中模板template_reject事件请将短信正文控制在 1000 个字符以内。）
`tag`	`string`	可选	无	自定义标签功能，该标签可用作SUBHOOK追踪（32 个字符以内，添加了 tag 参数的 API 请求，会在所有的 SUBHOOK 事件中携带此参数。tag参数不参加加密计算）
`timestamp`	UNIX 时间戳	可选	无	参阅 API 授权与验证机制 > `Timestamp` UNIX 时间戳
`sign_type`	`string`	可选	`normal`	API 授权模式（ `md5 or sha1 or normal` ）参阅 API 授权与验证机制 > 授权和验证方式
`sign_version`	`string`	可选	无	signature加密计算方式 (当sign_version传2时，content参数不参与加密计算)
`signature`	`string`	`必需`	无	应用密匙或数字签名参阅 API授权与验证机制 > 授权和验证方式。当sign_type=normal时signature应传appkey的值。

代码示例

发送一封测试短信

POST URL

https://api.mysubmail.com/message/send.json

POST DATA

appid=your_app_id
&amp;to=138xxxxxxxx
&amp;content=【SUBMAIL】您的短信验证码：4438，请在10分钟内输入。
&amp;signature=your_app_key

{"status": "success","send_id": "c2f0e679ad8dxxxxxf6cb71bf2925665e0","fee": 1,"sms_credits": "21129","transactional_sms_credits": "0"
}

使用 CURL 发送一封测试短信

发送 CURL

curl -d 'appid=your_app_id&amp;to=138xxxxxxxx&amp;content=【SUBMAIL】您的短信验证码：4438，请在10分钟内输入。&amp;signature=your_app_key' https://api.mysubmail.com/message/send.json

{"status": "success","send_id": "c2f0e679ad8dxxxxxf6cb71bf2925665e0","fee": 1,"sms_credits": "21129","transactional_sms_credits": "0"
}

返回值

请求成功

{"status": "success","send_id": "c2f0e679ad8dxxxxxf6cb71bf2925665e0","fee": 1,"sms_credits": "21129","transactional_sms_credits": "0"
}

请求失败

{"status":"error","code":"1xx","msg":"error message"
}

错误代码

参阅 API 错误代码

SUBMAIL短信平台API接口-Message/send相关推荐

SUBMAIL短信平台API接口-Message/xsend
API: Message/xsend 原文链接概览 message/xsend 是 SUBMAIL 的短信 API 的升级版本. 与 message/send API 一样,message/xsen ...
什么是短信平台api接口？
自从人类诞生了手机,短信便随之而来,虽然后来有了更多的即时通信工具,如QQ和微信,个人用短信的机会已经很少了,但是对于企业公司来说,短信一直是非常方便的信息传递工具. 那些带有营销性质的企业和商家会通 ...
短信平台API接口demo示例-JAVA/Message/Send
DEMO:Message/Send 原文链接支持JDK版本:1.5以上依赖的jar包:httpclient-4.5.3.jar.httpcore-4.4.14.jar.commons-loggin ...
短信平台API接口调用-SUBMAIL
一.下载SDK开发包前往文档中心 ->SDK 开发包下载页面,下载对应语言的SDK开发包. SUBMAIL 提供多种语言的开发包,SDK 集成了 SUBMAIL 的 API 请求方法,并将 A ...
短信平台API接口demo示例-Node/SMS/Send
DEMO: SMS/Send - 短信发送原文链接 var request = require('request'); var crypto = require('crypto'); var app ...
验证码短信平台API接口的应用
事实上,现在不论是企业商家还是用户,都现已渐渐离不开短信验证码接口途径了.因为现在很多工作都在经过短信验证码接口实现各种短信服务功用,例如帐号的注册.身份的验证.付出时的提示.物流告诉等等.那么接下来 ...
短信平台API接口demo示例-Node/SMS/MultiSend
DEMO: SMS/MultiSend - 短信一对多发送原文链接 var request = require('request'); var crypto = require('crypto'); ...
短信平台API接口demo示例-Node/SMS/XSend
DEMO: SMS/XSend - 短信模板发送原文链接 var request = require('request'); var crypto = require('crypto'); var ...
短信平台API接口demo示例-Python/SMS/MultiSend
DEMO: SMS/MultiSend - 短信一对多发送示例代码原文链接非加密代码示例 import requests import jsonappid = 'appid' # SUBMAIL ...
短信平台API接口demo示例-JAVA/Message/MultiXSend
DEMO:Message/MultiXSend 原文链接支持JDK版本:1.5以上依赖的jar包:httpclient-4.5.3.jar.httpcore-4.4.14.jar.commons- ...

SUBMAIL短信平台API接口-Message/send

API: Message/send

概览

URL

`<主> https://api.mysubmail.com/message/send`

`<备> https://api.submail.cn/message/send`

支持格式

http 请求方式

是否需要授权

是

参阅 API 授权和验证机制

请求参数

代码示例

发送一封测试短信

POST URL

POST DATA

返回

使用 CURL 发送一封测试短信

发送 CURL

返回

返回值

请求成功

请求失败

错误代码

参阅 API 错误代码

SUBMAIL短信平台API接口-Message/send相关推荐

最新文章

热门文章

SUBMAIL短信平台API接口-Message/send

API: Message/send

概览

** URL**

<主> https://api.mysubmail.com/message/send

<备> https://api.submail.cn/message/send

支持格式

http 请求方式

是否需要授权

是

参阅 API 授权和验证机制

请求参数

代码示例

发送一封测试短信

POST URL

POST DATA

返回

使用 CURL 发送一封测试短信

发送 CURL

返回

返回值

请求成功

请求失败

错误代码

参阅 API 错误代码

SUBMAIL短信平台API接口-Message/send相关推荐

最新文章

热门文章

URL

`<主> https://api.mysubmail.com/message/send`

`<备> https://api.submail.cn/message/send`