获取 Channel QR Session

轮询 Channel 扫码授权会话状态。

GET /api/v1/forward/qr_sessions/{session_key}

返回 QR 授权会话的当前状态。

​

请求头

Header	是否必填	说明
Authorization	是	Bearer <PAT>

​

路径参数

参数	类型	是否必填	说明
session_key	string	是	Create Channel QR Session 返回的不透明 session key。

​

示例请求

curl -s -X GET 'https://api.qoder.com/api/v1/forward/qr_sessions/qr-a1b2c3d4' \
  -H "Authorization: Bearer $QODER_PAT"

​

示例响应

HTTP 200 OK

{
  "session_key": "qr-a1b2c3d4",
  "channel_id": "channel_dingtalk-001",
  "channel_type": "dingtalk",
  "status": "confirmed",
  "expires_at": "2026-06-18T10:05:00Z"
}

​

响应字段

字段	类型	说明
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 无效或已过期。
404	not_found_error	QR session 不存在、已过期或当前调用方不可见。

​

注意事项

• session_key 是短生命周期的不透明凭证。
• 状态为 confirmed 后应刷新 Channel 详情。

​

相关

创建 Channel QR Session

获取 Channel