API: AddressBook/SMS/Subscribe - 短信订阅
概览
addressbook/sms/subscribe 是 SUBMAIL 的短信订阅 API ，使用 addressbook/sms/subscribe API 管理你的短信订阅用户。
URL
<主> https://api.mysubmail.com/addressbook/sms/subscribe
<备> https://api.submail.cn/addressbook/sms/subscribe
支持格式
| 格式 | URL |
|---|---|
json | https://api.mysubmail.com/addressbook/sms/subscribe.json（默认） |
xml | https://api.mysubmail.com/addressbook/sms/subscribe.xml |
http 请求方式
POST
是否需要授权
是
参阅 API 授权和验证机制
请求参数
| 参数 | 类型 | 必需/可选 | 默认 | 描述 |
|---|---|---|---|---|
appid | string | 必需 | 无 | 在 SUBMAIL 应用集成中创建的短信应用ID |
address | string | 必需 | 无 | 联系人 11 位 手机号码 e.g.13xxxxxxxxx |
target | string | 可选 | subscribe | 地址簿标识，将联系人添加到目标地址簿 忽略此参数，SUBMAIL 默认将联系人添加到订阅地址簿。 请参见 获取项目或地址簿的开发者标识 |
timestamp | UNIX 时间戳 | 必需 | 无 | 参阅 API 授权与验证机制 > Timestamp UNIX 时间戳 |
sign_type | string | 可选 | normal | API 授权模式（ md5 or sha1 or normal ）参阅 API 授权与验证机制 > 授权和验证方式 |
signature | string | 必需 | 无 | 应用密匙 或 数字签名 参阅 API 授权与验证机制 > 授权和验证方式 |
代码示例
添加一个短信联系人到订阅地址簿
POST
https://api.mysubmail.com/addressbook/sms/subscribe.jsonPOST Data
appid=your_app_id
&address=138xxxxxxxx
&signature=your_app_key返回
{
"status":"success"
}添加一个短信联系人到目标地址簿
POST
https://api.mysubmail.com/addressbook/sms/subscribe.jsonPOST Data
appid=your_app_id
&address=138xxxxxxxx
⌖=ThJBE4
&signature=your_app_key返回
{
"status":"success"
}使用 CURL 添加一个短信联系人到订阅地址簿
发送 CURL
curl -d 'appid=your_app_id&address=138xxxxxxxx&signature=your_app_key' https://api.mysubmail.com/addressbook/sms/subscribe.json返回
{
"status":"success"
}使用 CURL 添加一个短信联系人到目标地址簿
发送 CURL
curl -d 'appid=your_app_id&address=138xxxxxxxx⌖=ThJBE4&signature=your_app_key' https://api.mysubmail.com/addressbook/message/subscribe.json返回
{
"status":"success"
}返回值
请求成功
{
"status":"success"
}请求失败
{
"status":"error",
"code":"1xx",
"msg":"error message"
}