# 查询rid信息
# 接口说明
本接口用于查询调用公众号/小程序/第三方平台等接口报错返回的rid详情信息,辅助开发者高效定位问题;
接口应在服务器端调用,详细说明参见服务端API。
# 注意事项
由于查询rid信息属于开发者私密行为,因此仅支持同账号的查询。举个例子,rid=1111,是小程序账号A调用某接口出现的报错,那么则需要使用小程序账号A的access_token调用当前接口查询rid=1111的详情信息,如果使用小程序账号B的身份查询,则出现报错,错误码为xxx。公众号、第三方平台账号的接口同理;
如果是第三方服务商代公众号或者小程序查询公众号或者小程序的api返回的rid,则使用同一账号的authorizer_access_token调用即可;
rid的有效期只有7天,即只可查询最近7天的rid,查询超过7天的rid会出现报错,错误码为76001;
“/xxx/sns/xxx”这类接口不支持使用该接口,会出现76022报错。
# 接口调用请求说明
# HTTPS 调用
POST https://api.weixin.qq.com/cgi-bin/openapi/rid/get?access_token=ACCESS_TOKEN
# 第三方调用
调用方式以及出入参和HTTPS相同,仅是调用的token不同
# 请求参数说明
参数 | 类型 | 是否必填 | 描述 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token |
rid | string | 是 | 调用接口报错返回的rid |
# 请求参数示例
{
"rid":"61725984-6126f6f9-040f19c4"
}
# 返回参数说明
参数 | 类型 | 描述 | |||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
errcode | number | 返回码 | |||||||||||||||||||||||||||||
errmsg | string | 错误信息 | |||||||||||||||||||||||||||||
request | object | 该rid对应的请求详情 | |||||||||||||||||||||||||||||
|
# 返回参数示例
{"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"
}
}
# 错误码
错误码 | 错误信息 | 解决方案 |
---|---|---|
公共错误码 | - | - |
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 |