- 添加模版
- 请求
- 请求参数
- 响应
- Json返回值示例(国际短信模板):
添加模版
HTTP头信息:
Accept:application/json;charset=utf-8;
Content-Type:application/x-www-form-urlencoded;charset=utf-8;
请求
URL:https://sms.yunpian.com/v2/tpl/add.json
注意:海外服务器地址 us.yunpian.com
访问方式:POST
请求参数
参数名 | 类型 | 是否必须 | 描述 | 示例 |
---|---|---|---|---|
apikey | string | 是 | 用户唯一标识 | 9b11127a9701975c734b8aee81ee3526 |
tpl_content | string | 是 | 模板内容,必须以带符号【】的签名开头 | 【云片网】您的验证码是#code# |
lang | string | 是 | 国际短信模板所需参数,模板语言:简体中文zh_cn;英文en; 繁体中文 zh_tw; 韩文ko,日文 ja; 其他语言 other (其他语言功能需联系在线客服开通) | zh_cn |
notify_type | integer | 否 | 审核结果短信通知的方式: 0表示需要通知,默认; 1表示仅审核不通过时通知; 2表示仅审核通过时通知; 3表示不需要通知 | 1 |
callback | string | 否 | 审核结果会向这个地址推送,推送参数如下 | http://yourreceiveurl_address |
callback推送参数举例
名称 | 类型 | 描述 |
---|---|---|
tpl_id | string | 模板id |
tpl_content | string | 模板内容 |
check_status | string | //审核状态:CHECKING/SUCCESS/FAIL |
reason | string | 审核未通过的原因 |
响应
名称 | 类型 | 描述 |
---|---|---|
tpl_id | string | 模板id |
tpl_content | string | 模板内容 |
check_status | string | //审核状态:CHECKING/SUCCESS/FAIL |
reason | string | 审核未通过的原因 |
country_code | string | 支持地区 |
Json返回值示例(国际短信模板):
{
"tpl_id": 1,
"tpl_content": "【云片网】您的验证码是#code#",
"check_status": "CHECKING",
"reason": null
}
语言支持说明:
语言 | 代码 | 支持地区 |
---|---|---|
英文 | en | 全球所有国家地区 |
中文简体 | zh_cn | 大陆CN、台湾TW、香港HK、澳门MO |
中文繁体 | zh_tw | 大陆CN、台湾TW、香港HK、澳门MO、韩国KR |
韩文 | ko | 韩国KR |
日文 | ja | 日本JP |