获取 Channel QR Session

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

请求头

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

路径参数

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

示例请求

curl -s -X GET 'https://api.qoder.com.cn/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",
  "err_code": null,
  "err_msg": null
}

响应字段

字段	类型	说明
`session_key`	string	Create Channel QR Session 返回的 opaque session key。
`channel_id`	string	关联的 Channel ID。
`channel_type`	string	渠道类型（如 dingtalk）。
`status`	string	`waiting`、`scanned`、`confirmed`、`expired`、`denied` 或 `error`。
`expires_at`	string	QR session 过期时间（ISO 8601 格式）。
`err_code`	string\|null	失败时的渠道错误码。
`err_msg`	string\|null	失败时的渠道错误信息。

错误

HTTP	Type	Code	触发条件
404	`not_found_error`	`channel_qr_session_not_found`	QR session 不存在或当前调用方不可见。
401	`authentication_error`	`authentication_required`	PAT 无效或已过期。

备注

session_key 是短生命周期高熵 opaque token。
按创建响应中的 poll_interval_seconds 轮询。
状态为 confirmed 后应刷新 Channel 详情。

​请求头

​路径参数

​示例请求

​示例响应

​响应字段

​错误

​备注

​相关

请求头

路径参数

示例请求

示例响应

响应字段

错误

备注

相关