Criar sessão de QR code de canal - Qoder CN Series: Central de Documentação do Alibaba Cloud

Crie uma sessão de autorização por QR code de curta duração para um Channel.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`
`Content-Type`	Não	`application/json` se houver corpo na requisição.
`Idempotency-Key`	Não	Chave de idempotência opcional para requisições não seguras.

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`channel_id`	string	Sim	ID do Channel.

Exemplo de requisição

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

Exemplo de resposta

HTTP 200 OK

{
  "type": "channel_qr_session",
  "session_key": "qr-a1b2c3d4",
  "channel_id": "ci_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": 3
}

Campos da resposta

Campo	Tipo	Descrição
`type`	string	Sempre `channel_qr_session`.
`session_key`	string	Chave opaca da sessão de QR code para polling.
`channel_id`	string	ID do Channel associado.
`channel_type`	string	`wechat`, `feishu`, `dingtalk` ou `wecom`.
`status`	string	Status inicial, geralmente `waiting`.
`qr_code_content`	string	Conteúdo original do QR code, normalmente uma URL de autorização de terceiros.
`qr_code_image_base64`	string	Imagem do QR code gerada pelo Gateway.
`expires_at`	string	Timestamp de expiração.
`poll_interval_seconds`	integer	Intervalo recomendado para polling.

Erros

HTTP	Tipo	Código	Gatilho
400	`invalid_request_error`	`channel_type_unsupported`	O tipo de Channel não suporta sessões de QR code.
404	`not_found_error`	`channel_not_found`	O Channel não existe.
409	`conflict_error`	`channel_disabled`	O Channel está desabilitado.
502	`api_error`	`channel_auth_failed`	Falha na autorização do Gateway ou de terceiros.

Observações

As sessões de QR code P0 suportam wechat, feishu, dingtalk e wecom.
O qq não suporta sessões de QR code unificadas no P0.
O corpo da requisição pode ser omitido ou definido como {}.

Cabeçalhos da requisição

Parâmetros de caminho

Exemplo de requisição

Exemplo de resposta

Campos da resposta

Erros

Observações

APIs relacionadas