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

Consulte uma sessão de autorização QR de canal.

Cabeçalhos da requisição

Cabeçalho	Obrigatório	Descrição
`Authorization`	Sim	`Bearer <PAT>`

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição
`session_key`	string	Sim	Chave opaca da sessão QR retornada pela API Crie Channel QR Session.

Exemplo de requisição

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

Exemplo de resposta

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
}

Valores de status

Status	Descrição
`waiting`	Aguardando leitura, autorização, instalação ou configuração.
`scanned`	Código QR lido; aguardando confirmação no dispositivo móvel.
`confirmed`	Ativação bem-sucedida. O `binding_status` do canal torna-se `bound`.
`expired`	Sessão QR expirada. Crie uma nova sessão QR.
`denied`	O usuário negou a autorização ou cancelou a instalação.
`error`	O gateway ou o canal de terceiros retornou um erro irrecuperável.

Erros

HTTP	Tipo	Código	Gatilho
401	`authentication_error`	`authentication_required`	PAT inválido ou expirado.
404	`not_found_error`	`channel_qr_session_not_found`	A sessão QR não existe, expirou ou não está visível para o chamador.

Observações

O session_key é um token opaco de alta entropia e curta duração.
Consulte periodicamente respeitando o valor de poll_interval_seconds retornado na resposta de criação.
Após o status confirmed, atualize os detalhes do canal.

Cabeçalhos da requisição

Parâmetros de caminho

Exemplo de requisição

Exemplo de resposta

Valores de status

Erros

Observações

APIs relacionadas