メインコンテンツへスキップ
GET /api/v1/forward/qr_sessions/{session_key} QR 認可セッションの現在のステータスを返します。

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer <PAT>

​
Path parameters

ParameterTypeRequiredDescription
session_keystringYesCreate Channel QR Session が返す不透明な QR セッションキー。

​
Example request

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

​
Example response

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
}

​
Status values

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

​
Errors

HTTPTypeCodeTrigger
401authentication_errorauthentication_requiredPAT が無効または期限切れです。
404not_found_errorchannel_qr_session_not_foundQR セッションが存在しない、期限切れ、または呼び出し元から参照できません。

​
Notes

  • session_key は短時間有効な不透明なポーリング用の認証情報です。
  • create レスポンスで返された poll_interval_seconds の間隔でポーリングしてください。
  • confirmed になった後は、Channel の詳細を再取得してください。

チャネル QR セッションの作成

チャネルの取得