# 查询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
其他错误码 请查看全局错误码