API: InternationalSMS/Template - 国际短信模版管理


概览


internationalsms/template 是 SUBMAIL 的国际短信模板 API。

使用 internationalsms/template 可以获取、创建、编辑或删除您的短信模板。

internationalsms/template API 使用 HTTP 规范中的 GET, POST, PUT, DELETE 方法对模板进行操作,使用 GET 方法获取单个或全部模板、POST 方法创建新的短信模板并提交至 SUBMAIL 人工审核、PUT 方法更新或编辑一个短信模板,或使用 DELETE 方法删除一个模板。

短信模板引擎支持 SUBHOOK 异步推送状态,短信模板在后台人工审核后,会使用 SUBHOOK 进行主动推送状态。



URL


https://api-v4.mysubmail.com/internationalsms/template


支持格式


格式URL
jsonhttps://api-v4.mysubmail.com/internationalsms/template.json (默认)
xmlhttps://api-v4.mysubmail.com/internationalsms/template.xml
yamlhttps://api-v4.mysubmail.com/internationalsms/template.yaml


http 请求方式


  • GET 获取全部模板列表,或获取指定的单个模板
  • POST 创建一个新的短信模板,并提交至 SUBMAIL 进行人工审核
  • PUT 编辑或更新一个短信模板,并提交至 SUBMAIL 进行人工审核
  • DELETE 删除一个短信模板


是否需要授权


参阅 API 授权和验证机制


internationalsms/template GET 方法(获取模板列表)请求参数


参数类型必需/可选默认描述
appidstring必需在 SUBMAIL 应用集成中创建的短信应用 ID
template_idstring可选模板ID
(要获取单个模板,请将在此参数中提交该模板 ID。为空则获取最新的 1000 个短信模板)
timestampUNIX 时间戳可选参阅 API 授权与验证机制 > Timestamp UNIX 时间戳
sign_typestring可选normalAPI 授权模式( md5 or sha1 or normal
参阅 API 授权与验证机制 > 授权和验证方式
signaturestring必需应用密匙或数字签名
参阅 API 授权与验证机制 > 授权和验证方式


internationalsms/template POST 方法(创建模板)请求参数


参数类型必需/可选默认描述
appidstring必需在 SUBMAIL 应用集成中创建的短信应用 ID
sms_titlestring可选模板标题
(创建模板时可以在此参数中提交当前模板的标题,作为模板标记)
sms_contentstring必需短信正文
(提交短信模板正文,请将模板正文字数控制在 500 个字符以内。可使用文本变量 参阅了解如何创建和使用文本变量)
timestampUNIX 时间戳可选参阅 API 授权与验证机制 > Timestamp UNIX 时间戳
sign_typestring可选normalAPI 授权模式( md5 or sha1 or normal
参阅 API 授权与验证机制 > 授权和验证方式
signaturestring必需应用密匙或数字签名
参阅 API授权与验证机制 > 授权和验证方式


internationalsms/template PUT 方法(更新模板)请求参数


参数类型必需/可选默认描述
appidstring必需在 SUBMAIL 应用集成中创建的短信应用 ID
template_idstring必需需要更新的模板 ID
(在 SUBMAIL > internationalsms >项目中查看您所创建的短信模版 ID。请参见 获取项目 ID
sms_titlestring可选模板标题
(创建模板时可以在此参数中提交当前模板的标题,作为模板标记)
sms_contentstring必需短信正文
(提交短信模板正文,请将模板正文字数控制在500个字符以内。可使用文本变量 参阅了解如何创建和使用文本变量)
timestampUNIX 时间戳可选参阅 API 授权与验证机制 > Timestamp UNIX 时间戳
sign_typestring可选normalAPI 授权模式( md5 or sha1 or normal
参阅 API 授权与验证机制 > 授权和验证方式
signaturestring必需应用密匙或数字签名
参阅 API授权与验证机制 > 授权和验证方式


internationalsms/template DELETE 方法(删除模板)请求参数


参数类型必需/可选默认描述
appidstring必需在 SUBMAIL 应用集成中创建的短信应用ID
template_idstring可选需要删除的模板 ID
(在 SUBMAIL > internationalsms >项目中查看你所创建的短信模版 ID。请参见 获取项目 ID)
timestampUNIX 时间戳可选参阅 API 授权与验证机制 > Timestamp UNIX 时间戳
sign_typestring可选normalAPI 授权模式( md5 or sha1 or normal
参阅 API 授权与验证机制 > 授权和验证方式


代码示列


使用 CURL GET方法获取模板列表


发送 CURL
curl -s "https://api-v4.mysubmail.com/internationalsms/template.json?appid=your_appid&signature=your_appkey"


返回
{
"status": "success",
"template": {
    "template_id": "FIJe14",
    "sms_title": "账户更改邮箱验证码",
    "sms_content": "您正在执行更改登录邮箱操作,验证码:@var(code) ,请在工单内提供此验证码",
    "add_date": "2016-01-08 21:28:04",
    "edit_date": "2016-01-08 21:28:04",
    "template_status": "2",
    "template_status_description": "通过审核"
    }
}


使用 CURL POST方法提交短信模板


发送 CURL
curl -d "appid=your_appid&signature=your_appkey&sms_title=POST方法测试&sms_content=您的验证码是:@var(code),请在10分钟内输入。" http://api.mysubmail.com/internationalsms/template.json


返回
{
    "status": "success",
    "template_id": "FsoAF3"    // API 返回的模板ID,作为请求 API 的 PROJECT 参数
}


使用 CURL PUT 方法修改短信模板


发送 CURL
curl --data "appid=your_appid&signature=your_appkey&template_id=FsoAF3&sms_title=PUT方法更新模板测试&&sms_content=您的验证码是:@var(code),请在30分钟内输入。" -X put http://api.mysubmail.com/internationalsms/template.json


返回
{
    "status":"success"
}


使用 CURL DELETE 方法删除短信模板


发送 CURL


curl --data "appid=your_appid&signature=your_appkey&template_id=FsoAF3" -X delete http://api.mysubmail.com/internationalsms/template.json


返回
{
    "status":"success"
}


template_status 模板状态描述


模板状态描述
template_status : 0未提交审核
template_status : 1正在审核
template_status : 2审核通过
template_status : 3未通过审核


返回值


请求成功
{
    "status":"success"
}


请求失败
{
    "status":"error",
    "code":"1xx",
    "msg":"error internationalsms"
}


错误代码


参阅 API 错误代码