# 用户阅读通知情况

发送通知后,可通过通知标识值(mark)和具体的学号查询该被通知成员是否已读通知。

# 1.接口地址

# 请求方法:

POST(application/json)

# 请求地址:

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

注:若私有化部署,接口地址域名变更私有化域名

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

# 2.请求参数

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

# 3.返回数据

# 响应说明:

{
    "code": 0,
    "message":'ok',
    "read":1
}
参数 是否可空 说明
code 非空 返回码(0表示成功)
message 非空 提示信息
read 可空 状态码 0:未读;1:已读

# 错误返回:

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

# 4.错误码

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