Qoder CN Series:Get channel QR session

Request headers

Header	Required	Description
Authorization	Yes	Bearer <PAT>

Path parameters

Parameter	Type	Required	Description
session_key	string	Yes	Opaque QR session key returned by Create Channel QR Session.

Example request

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

Example response

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
}

Status values

Status	Description
waiting	Waiting for scan, authorization, installation, or configuration.
scanned	QR code was scanned and is waiting for mobile confirmation.
confirmed	Activation succeeded. Channel binding_status becomes bound.
expired	QR session expired. Create a new QR session.
denied	User denied authorization or cancelled installation.
error	Gateway or third-party channel returned an unrecoverable error.

Errors

HTTP	Type	Code	Trigger
401	authentication_error	authentication_required	PAT invalid or expired.
404	not_found_error	channel_qr_session_not_found	QR session does not exist, is expired, or is not visible to the caller.

Notes

• session_key is a short-lived high-entropy opaque token.

• Poll at the returned poll_interval_seconds from the create response.

• After confirmed, refresh Channel details.

Related APIs

• Create Channel QR Session

• Get Channel