AI Coding Assistant Lingma:Obter sessão QR do canal

Cabeçalhos de solicitaçã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 de sessão QR opaca retornada pela API Create Channel QR Session.

Exemplo de solicitaçã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 digitalização, autorização, instalação ou configuração.
scanned	O código QR foi digitalizado e aguarda confirmação no dispositivo móvel.
confirmed	Ativação bem-sucedida. O binding_status do canal torna-se bound.
expired	A sessão QR expirou. Crie uma nova sessão QR.
denied	O usuário negou a autorização ou cancelou a instalação.
error	O gateway ou 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, está expirada ou não é visível para o chamador.

Observações

• session_key é um token opaco de alta entropia com vida útil curta.

• Consulte no intervalo poll_interval_seconds retornado na resposta de criação.

• Após confirmed, atualize os detalhes do canal.

APIs relacionadas

• Criar sessão QR do canal

• Obter canal