查詢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 |
其他錯誤碼 | 請查看全局錯誤碼 |