# 查询rid信息

调试工具

接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南

接口英文名:getRidInfo

本接口用于查询调用公众号/服务号/小程序/小游戏/微信小店/带货助手/视频号助手/联盟带货机构/移动应用/网站应用/多端应用/第三方平台等接口报错返回的rid详情信息,辅助开发者高效定位问题。

# 1. 调用方式

# HTTPS 调用

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

# 云调用

  • 本接口不支持云调用

# 第三方调用

# 2. 请求参数

# 查询参数 Query String parameters

参数名类型必填说明
access_tokenstring接口调用凭证,可使用 access_tokencomponent_access_token

# 请求体 Request Payload

参数名类型必填说明
ridstring调用接口报错返回的rid

# 3. 返回参数

# 返回体 Response Payload

参数名类型说明
errcodenumber返回码
errmsgstring错误信息
requestobject该rid对应的请求详情

# Res.request Object Payload

该rid对应的请求详情

参数名类型说明
invoke_timenumber发起请求的时间戳
cost_in_msnumber请求毫秒级耗时
request_urlstring请求的URL参数
request_bodystringpost请求的请求参数
response_bodystring接口请求返回参数
client_ipstring接口请求的客户端ip

# 4. 注意事项

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

4、”/xxx/sns/xxx“这类接口不支持使用该接口,会出现76022报错。

# 5. 代码示例

请求示例

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

# 6. 错误码

以下是本接口的错误码列表,其他错误码可参考 通用错误码

错误码错误描述解决方案
0okok
76001rid not foundrid不存在
76002rid is errorrid为空或者格式错误
76003could not query this rid,no permission当前账号无权查询该rid,该rid属于其他账号调用所产生
76004rid time is errorrid过期,仅支持持续7天内的rid

# 7. 适用范围

本接口在不同账号类型下的可调用情况:
小程序公众号服务号小游戏微信小店联盟带货机构带货助手第三方平台移动应用网站应用视频号助手多端应用