腾讯微卡Wiki

# 查询通知能力

在发送通知前，获取该主体的公众号（一般为发卡公众号）是否具有公众号模板消息通知能力。

# 1.申请方式

需发送应用名称、应用APPKEY和使用场景到johanzheng@tencent.com进行申请(邮件同时也抄送至hongfuhuang@tencent.com，ronniewan@tencent.com，marshalyang@tencent.com)

# 2.接口地址

# 请求方法：

POST(application/json)

# 请求地址：

https://uni.weixiao.qq.com/open/notice/ability

注：若私有化部署，接口地址域名变更私有化域名

注意：本地部署的主体不能使用上面接口地址，需要根据主体本地域名拼上对应的路径，例如主体域名是https://XXXX.com，那么这里调用的接口地址应该是https://XXXX.com/open/notice/ability

# 3.请求参数

# 参数说明：

{
    "school_code": "SCHOOL_CODE",
    "app_key": "APP_KEY",
    "timestamp": "TIMESTAMP",
    "nonce": "NONCE",
    "signature": "SINGATURE"
}
参数 必填 示例值 类型 说明
school_code 是 4111010001 int(10) 主体标识码，查看主体代码 (opens new window)
app_key 是 CA1D905AC89ACDCA String(16) 腾讯微卡分配
timestamp 是 1514276659 int 当前unix时间戳
nonce 是 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串
signature 是 A790E009D30C09BD8605810EAF9C44B0 String(32) 按照签名算法生成的签名

# 4.返回数据

# 响应说明：

{
    "code": 0,
    "message":'ok'
}
参数 是否可空 说明
code 非空 返回码（0表示成功）
message 非空 提示信息

# 错误返回：

{
    "code": xxx,(非0错误码)
    "message": xxx,(错误信息)
}

# 5.错误码

名称 解决方案
1003 没有权限（请联系腾讯微卡工作人员开通该权限）
1023 签名校验失败（请参考全局需知—签名算法）
47001 主体标识码不合法（请核对参数school_code）
47002 该主体的公众号为非发卡公众号
47003 该主体的公众号为非认证服务号，仅限认证服务号使用
47004 该主体的公众号没有授权腾讯微卡消息管理权限
47005 该主体的公众号模板消息设置有误，请参照http://weixiao.qq.com/notice/view?mid=0&cid=2&id=314