getRidInfo.md

openApi管理 /查询RID信息

查询 RID 信息

接口应在服务器端调用，详细说明参见服务端API。

接口说明

接口英文名

getRidInfo

功能描述

本接口用于查询调用公众号/小程序/第三方平台等接口报错返回的 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

调用方式

HTTPS 调用

POST https://api.weixin.qq.com/cgi-bin/openapi/rid/get?access_token=ACCESS_TOKEN 

第三方调用

• 调用方式以及出入参和 HTTPS 相同，仅是调用的 token 不同

请求参数

属性	类型	必填	说明
access_token	string	是	第三方平台接口调用凭证authorizer_access_token，该参数为 URL 参数，非 Body 参数。
rid	string	是	调用接口报错返回的rid

返回参数

	属性	类型	说明
	errcode	number	返回码
	errmsg	string	错误信息
	request	object	该 rid 对应的请求详情
	属性类型说明invoke_timenumber发起请求的时间戳cost_in_msnumber请求毫秒级耗时request_urlstring请求的 URL 参数request_bodystringpost请求的请求参数response_bodystring接口请求返回参数client_ipstring接口请求的客户端ip

调用示例

示例说明: HTTPS请求

请求数据示例

{
"rid":"61725984-6126f6f9-040f19c4"
} 

返回数据示例

{"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"
          
  }
      
  } 

错误码

错误码	错误码取值	解决方案
0	ok	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