Create channel QR session

POST /api/v1/forward/channels/{channel_id}/qr_sessions Creates a QR session that can activate or rebind supported channels.

Headers

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT>`
`Content-Type`	No	`application/json` if a body is sent.
`Idempotency-Key`	No	Optional idempotency key for unsafe requests.

Path parameters

Parameter	Type	Required	Description
`channel_id`	string	Yes	Channel ID.

Example request

curl -s -X POST 'https://api.qoder.com/api/v1/forward/channels/channel_dingtalk-001/qr_sessions' \
  -H "Authorization: Bearer $QODER_PAT" \
  -H "Content-Type: application/json" \
  -d '{}'

Example response

HTTP 200 OK

{
  "session_key": "qr-a1b2c3d4",
  "channel_id": "channel_dingtalk-001",
  "channel_type": "dingtalk",
  "status": "waiting",
  "qr_code_content": "https://login.dingtalk.com/oauth2/...",
  "qr_code_image_base64": "data:image/png;base64,...",
  "expires_at": "2026-06-18T10:05:00Z",
  "poll_interval_seconds": 2
}

Response fields

Field	Type	Description
`session_key`	string	Opaque QR session key used for polling.
`channel_id`	string	Associated Channel ID.
`channel_type`	string	`wechat`, `feishu`, `dingtalk`, or `wecom`.
`status`	string	Initial status, usually `waiting`.
`qr_code_content`	string	Original QR content, usually a third-party authorization URL.
`qr_code_image_base64`	string	QR image generated by the service.
`expires_at`	string	Expiration timestamp.
`poll_interval_seconds`	integer	Recommended polling interval.

Error codes

HTTP	Type	Trigger
400	`invalid_request_error`	Channel type does not support QR sessions.
401	`authentication_error`	PAT is invalid or expired.
404	`not_found_error`	Channel does not exist.
409	`conflict_error`	Channel is disabled.
502	`api_error`	Third-party channel authorization failed.

Notes

QR sessions currently support wechat, feishu, dingtalk, and wecom.
The request body may be omitted or {}.

Create channel QR session

Headers

Path parameters

Example request

Example response

Response fields

Error codes

Notes

Get channel QR session

Get a channel

​Headers

​Path parameters

​Example request

​Example response

​Response fields

​Error codes

​Notes

​Related

Get channel QR session

Get a channel

Headers

Path parameters

Example request

Example response

Response fields

Error codes

Notes

Related