# 用户阅读通知情况
发送通知后,可通过通知标识值(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是否为该校成员) |