模板短信状态报告查询
3.5(共48人评价)

应用主动查询状态报告(根据indentifier)

请求地址
http://api.189.cn/v2/EMP/nsagSms/appnotify/querysmsstatus
响应格式
JSON 、
HTTP请求方式
POST 、
是否需要授权
不需要
请求参数
参数名 必须 类型及范围 说明
app_id true string 应用ID,开发者创建应用时,天翼开放平台会为应用自动分配此ID,开发者进入"管理中心",在“应用详情”中可查看app_id。
access_token true string 访问令牌,是调用平台能力接口的通行证,可通过调用"令牌接口"获得。
identifier true string 短信唯一标识,成功调用“发送模板短信”接口时返回。
timestamp true string 时间戳,格式为:yyyy-MM-dd HH:mm:ss
sign true string 参数签名,详见下说明。 1、签名规则:将以下“签名参数”按照key进行字典升序后,以“key1=value1&key2=value2…”的形式拼接起来,依次进行HMAC-SHA1和BASE64两步加密后得出的密文; 2、签名参数:该接口所有请求参数当中,除了“sign”本身和已标明不参与签名的特殊参数(如图片)外,均为参与签名的参数,即签名参数; 3、HMAC-SHA1加密密钥:即应用密钥(App Secret),开发者创建应用时,天翼开放平台会为应用自动分配,开发者进入"管理中心",在"应用详情"中可查看App Secret; 4、数据编码:HMAC-SHA1和BASE64加密过程中,均采用utf-8编码方式; 5、举例说明:假设应用密钥为“appSecret”,签名参数列表“foo=1,bar=2,baz=3”,拼接排序后为“bar=2&baz=3&foo=1”,那么,sign的值为BASE64(HMAC-SHA1("bar=2&baz=3&foo=1","appSecret"))。
请求参数示例
POST /app/example Http/1.1
Content-Type: application/x-www-form-urlencoded
Host:www.example.com

app_id=xxx&access_token=yyy&identify=zzz&timestamp=xyz&sign=zyx
响应结果
参数名 类型及范围 说明
res_code string 响应码。
identifier string 短信唯一标识,成功调用“发送模板短信”接口时返回。
status string 状态报告(0代表成功,1代表失败)
res_message string 响应信息。
响应结果示例:
JSON
 {
  "res_code": "0",
  "identifier": "90610108163847000108",
  "status ": "0",
  "res_message": ""
}