GET /api/v1/forward/qr_sessions/{session_key}
返回 QR 授权会话的当前状态。
请求头
| Header | 是否必填 | 说明 |
|---|---|---|
| Authorization | 是 | Bearer <PAT 或 SAT> |
路径参数
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| session_key | string | 是 | Create Channel QR Session 返回的不透明 session key。 |
示例请求
示例响应
HTTP 200 OK
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
| session_key | string | QR session 的不透明 key。 |
| channel_id | string | 关联的 Channel ID。 |
| channel_type | string | 关联的渠道类型。 |
| status | string | waiting、scanned、confirmed、expired、denied 或 error。 |
| expires_at | string | QR session 过期时间。 |
| err_code | string | null | 失败时的渠道错误码。 |
| err_msg | string | null | 失败时的渠道错误信息。 |
错误码
| HTTP | Type | 触发条件 |
|---|---|---|
| 401 | authentication_error | PAT 或 SAT 无效或已过期。 |
| 404 | not_found_error | QR session 不存在、已过期或当前调用方不可见。 |
注意事项
session_key是短生命周期的不透明凭证。- 状态为
confirmed后应刷新 Channel 详情。