全部产品
Search

搜索本产品

    Qoder CN 系列：获取 Channel QR Session

    文档中心

    Qoder CN 系列：获取 Channel QR Session

    更新时间：Jul 15, 2026

    轮询 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 详情。

    相关