Qoder CN シリーズ:チャネル QR コードセッションの取得

リクエストヘッダー

ヘッダー	必須	説明
Authorization	はい	Bearer <PAT>

パスパラメーター

パラメーター	型	必須	説明
session_key	string	はい	Create Channel QR Session API から返される、不透明な QR コードセッションキー。

リクエスト例

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

レスポンス例

HTTP 200 OK

{
  "type": "channel_qr_session",
  "session_key": "qr-a1b2c3d4",
  "channel_id": "ci_dingtalk_001",
  "channel_type": "dingtalk",
  "status": "confirmed",
  "expires_at": "2026-06-18T10:05:00Z",
  "err_code": null,
  "err_msg": null
}

ステータス値

ステータス	説明
waiting	スキャン、認可、インストール、または設定を待機しています。
scanned	QR コードがスキャンされ、モバイル側の確認を待機しています。
confirmed	アクティベーションに成功しました。チャネルの binding_status は bound (バインド済み) になります。
expired	QR セッションの有効期限が切れました。新しい QR セッションを作成してください。
denied	ユーザーが認可を拒否、またはインストールをキャンセルしました。
error	ゲートウェイまたはサードパーティのチャネルが回復不能なエラーを返しました。

エラー

HTTP	タイプ	コード	原因
401	authentication_error	authentication_required	PAT が不正、または有効期限切れです。
404	not_found_error	channel_qr_session_not_found	QR セッションが存在しない、有効期限が切れている、または呼び出し元から参照できません。

注記

• session_key は、有効期間が短い高エントロピーの不透明なトークンです。

• 作成レスポンスで返される poll_interval_seconds に従ってポーリングしてください。

• confirmed の後、チャネルの詳細を更新してください。

関連API

• Create Channel QR Session API

• Get Channel API