全部產品
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 詳情。

    相關