# 用户阅读通知情况
发送通知后,可通过通知标识值(mark)和具体的电子卡号查询该被通知成员是否已读通知。
# 1.申请方式
发送邮件到seasonyuan@tencent.com进行申请(邮件同时也抄送至lydiaxyang@tencent.com , lindayyang@tencent.com , ronniewan@tencent.com),申请时需要注明应用APPKEY、应用名称、及应用使用场景
# 2.接口地址
# 请求方法:
POST(application/json)
# 请求地址:
https://open.wecard.qq.com/cgi-bin/notice/read?access_token=access_token
注:若私有化部署,接口地址域名变更私有化域名
# 3.请求参数
{
"mark": "MARK",
"card_number": "CARD_NUMBER"
}
参数 | 必填 | 示例值 | 类型 | 说明 |
---|---|---|---|---|
access_token | 是 | k3yCoY5VYHWyVhgUPud2mtfOFvRvossc | String | 授权有效凭证 (opens new window) |
mark | 是 | 980e4e04f5902d42264ba7e8241b7ca1 | String | 通知标识 |
card_number | 是 | 123456789 | String | 学号 |
# 4.返回数据
# 响应说明:
{
"code": 0,
"message":'ok',
"read":1
}
参数 | 是否可空 | 说明 |
---|---|---|
code | 非空 | 返回码(0表示成功) |
message | 非空 | 提示信息 |
read | 可空 | 状态码 0:未读;1:已读 |
# 5.错误码
名称 | 解决方案 |
---|---|
1003 | 没有权限(请联系微校工作人员开通该权限) |
1004 | 参数错误(请核对参数mark来自接口发送通知 (opens new window)) |
1023 | 签名校验失败(请参考全局需知—签名算法 (opens new window)) |
47006 | 不合法的card_number(请核对参数card_number是否为该校成员) |
# 注意事项
- 私有化部署的主体不能使用上面接口地址,需要根据主体私有化部署域名拼上对应的路径,主体私有化网关域名(私有化部署域名+/kong)