API: Message/xsend

小狼用的就这家的，所以分享一下。
message/xsend 是 SUBM 的升级版本。一般用来触发短信服务。

与 message/send API 一样，message/xsend 提供完整且强大的短信发送功能，区别在于，message/xsend 无需提交短信内容和短信签名，仅需提交你在 SUBMAIL MESSA（请参见 获取项目或地址薄的开发者标识）GE 应用程序中创建的短信项目的标记，并可以使用文本变量动态的控制每封短信的内容。 了解如何使用文本变量。

使用 message/xsend API 你将可以使用 SUBMAIL SMS EDITOR 高效、可视化地创建你的短信模板。当用户请求使用此项目进行触发时，SUBMAIL 会立即执行发送动作，无需担心发送延迟问题。



URL
https://api.submail.cn/message/xsend


支持格式
json

https://api.submail.cn/message/xsend.json

默认

xml

https://api.submail.cn/message/xsend.xml


http 请求方式
POST

是否需要授权
是

参阅 API 授权和验证机制

请求参数
参数

类型

必需/可选

默认

描述

appid

string

必需

无
在 SUBMAIL 应用集成中创建的短信应用 ID

to

string

必需

无
收件人手机号码，现在短信仅支持一对一模式（即单条API请求仅能发送一个联系人），该参数现在仅能提交一个位联系人

仅支持单个手机号码
project

string

必需 无
项目标记 (ID)

在 SUBMAIL > Message >项目中查看你所创建的短信项目标记。请参见 获取项目或地址薄的开发者标识
vars

json string

可选

无
使用文本变量动态控制短信中的文本

参阅 了解如何创建和使用文本变量

timestamp

UNIX 时间戳

可选 无 参阅 API 授权与验证机制 > Timestamp UNIX 时间戳
sign_type

string

可选

normal
API 授权模式（ md5 or sha1 or normal ）

参阅 API 授权与验证机制 > 授权和验证方式

signature

string

必需

无
应用密匙 或 数字签名

参阅 API 授权与验证机制 > 授权和验证方式

代码示例
发送一封测试短信

JSON
xml

POST

https://api.submail.cn/message/xsend.json
POST Data

appid=your_app_id
&to=138xxxxxxxx
&project=ThJBE4
&signature=your_app_key
返回

{
"status":"success"
"send_id":"093c0a7df143c087d6cba9cdf0cf3738"
"fee":1,
"sms_credits":14197
}


使用 CURL 发送一封测试短信

JSON
xml

发送 CURL

curl -d 'appid=your_app_id&to=138xxxxxxxx&project=ThJBE4&signature=your_app_key' https://api.submail.cn/message/xsend.json
返回

{
"status":"success"
"send_id":"093c0a7df143c087d6cba9cdf0cf3738"
"fee":1,
"sms_credits":14197
}




返回码
JSON
xml

请求成功

{
"status":"success"
"send_id":"093c0a7df143c087d6cba9cdf0cf3738"
"fee":1,
"sms_credits":14197
}
请求失败

{
"status":"error",
"code":"1xx",
"msg":"http://submail.cn/

转载：http://submail.cn/