腾讯微卡Wiki

# 通知数据明细

发送通知后，可通过通知标识值(mark)查询该通知的数据明细情况。

# 1.申请方式

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

# 2.接口地址

# 请求方法：

POST(application/json)

# 请求地址：

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

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

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

# 3.请求参数

{
    "mark": "MARK",
    "app_key": "APP_KEY",
    "timestamp": "TIMESTAMP",
    "nonce": "NONCE",
    "signature": "SINGATURE"
}
参数 必填 示例值 类型 说明
mark 是 980e4e04f5902d42264ba7e8241b7ca1 String 通知标识
app_key 是 CA1D905AC89ACDCA String(16) 腾讯微卡分配
timestamp 是 1514276659 int 当前unix时间戳
nonce 是 5K8264ILTKCH16CQ2502SI8ZNMTM67VS String(32) 随机字符串
signature 是 A790E009D30C09BD8605810EAF9C44B0 String(32) 按照签名算法生成的签名

# 4.返回数据

# 响应说明：

{
    "code": 0,
    "message":'ok',
    "details":{
        "push_num":100,
        "remind_num":80,
        "read_num":50
    }
}
参数 是否可空 说明
code 非空 返回码（0表示成功）
messsage 非空 提示信息
details 可空 详情
push_num 可空 推送人数
remind_num 可空 成功提醒人数
read_num 可空 已读人数

# 错误返回：

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

# 5.错误码

名称 解决方案
1003 没有权限（请联系腾讯微卡工作人员开通该权限）
1004 参数错误（请核对参数mark来自接口发送通知）
1023 签名校验失败（请参考全局需知—签名算法）