# 查询rid信息
- 本接口用于查询调用公众号/小程序/第三方平台等接口报错返回的rid详情信息,辅助开发者高效定位问题。
# 注意事项
1、由于查询rid信息属于开发者私密行为,因此仅支持同账号的查询。举个例子,rid=1111,是小程序账号A调用某接口出现的报错,那么则需要使用小程序账号A的access_token调用当前接口查询rid=1111的详情信息,如果使用小程序账号B的身份查询,则出现报错,错误码为xxx。公众号、第三方平台账号的接口同理。
2、如果是第三方服务商代公众号或者小程序查询公众号或者小程序的api返回的rid,则使用同一账号的authorizer_access_token调用即可
3、rid的有效期只有7天,即只可查询最近7天的rid,查询超过7天的rid会出现报错,错误码为76001
# 请求地址
POST https://api.weixin.qq.com/cgi-bin/openapi/rid/get?access_token=ACCESS_TOKEN
# 请求参数说明
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 依据需要查询的接口属于的账号类型不同而使用不同的token,详情查看注上述注意事项 |
rid | string | 是 | 调用接口报错返回的rid |
请求示例:
{
"rid":"61725984-6126f6f9-040f19c4"
}
# 返回参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | Number | 返回码 |
errmsg | String | 错误信息 |
request | object | 该rid对应的请求详情 |
# request结构体
参数 | 类型 | 说明 |
---|---|---|
invoke_time | timestamp | 发起请求的时间戳 |
cost_in_ms | Number | 请求毫秒级耗时 |
request_url | String | 请求的URL参数 |
request_body | String | post请求的请求参数 |
response_body | String | 接口请求返回参数 |
client_ip | String | 接口请求的客户端ip |
返回结果示例:
{"errcode":0,
"errmsg":"ok",
"request":{
"invoke_time":1635156704,
"cost_in_ms":30,
"request_url":"access_token=50_Im7xxxx",
"request_body":"",
"response_body":"{\"errcode\":45009,\"errmsg\":\"reach max api daily quota limit rid: 617682e0-09059ac5-34a8e2ea\"}",
"client_ip": "113.xx.70.51"
}
}
# 返回码说明
返回码 | errmsg | 说明 |
---|---|---|
0 | ok | 查询成功 |
76001 | rid not found | rid不存在 |
76002 | rid is error | rid为空或者格式错误 |
76003 | could not query this rid,no permission | 当前账号无权查询该rid,该rid属于其他账号调用所产生 |
76004 | rid time is error | rid过期,仅支持持续7天内的rid |
其他错误码 | 请查看全局错误码 |