# 查询服务卡片状态
接口应在服务器端调用,详细说明参见服务端API。
# 接口说明
# 接口英文名
getUserNotify
# 功能描述
查询服务卡片状态
# 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/wxa/get_user_notify?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
该接口所属的权限集id为:18
服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用
# 请求参数
属性 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token |
openid | string | 是 | 用户身份标识符 |
notify_code | string | 是 | 动态更新令牌 |
notify_type | number | 是 | 卡片id |
# 返回参数
属性 | 类型 | 说明 | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | 错误码 | |||||||||||||||||||||
errmsg | string | 错误信息 | |||||||||||||||||||||
notify_info | object | 卡片状态 | |||||||||||||||||||||
|
# 调用示例
示例说明: 成功返回
# 请求数据示例
{
"openid": "xxx",
"notify_type": 1001,
"notify_code": "xxx"
}
# 返回数据示例
{
"errcode":0,
"errmsg":"ok",
"notify_info": {
"notify_type": 1001,
"content_json": "{\"cur_status\":2,\"license_plate\":\"粤A·12345A\",\"arrival_time\":1679569348,\"wxa_path_query\":\"\"}",
"code_state": 1,
"code_expire_time" : 1681906267
}
}
示例说明: 异常返回
# 请求数据示例
{
"openid": "xxx",
"notify_type": 1001,
"notify_code": "xxx"
}
# 返回数据示例
{
"errcode": 85437,
"errmsg": "invalid notify_code"
}
# 错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
40003 | invalid openid | 不合法的 OpenID ,请开发者确认 OpenID 的有效性 |
85431 | system error | 系统繁忙,稍后重试 |
85434 | invalid notify_type | notify_type 参数不合法 |
85437 | invalid notify_code | notify_code 不存在 |
85438 | notify_code expired | notify_code 已过期 |