Todos os produtos
Search
Central de documentação

Qoder CN Series:Obter sessão QR de canal

Última atualização: Jul 15, 2026

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.