Consulte uma sessão de autorização QR do canal.
Cabeçalhos de solicitação
|
Cabeçalho |
Obrigatório |
Descrição |
|
|
Sim |
|
Parâmetros de caminho
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
|
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 |
|
|
Aguardando digitalização, autorização, instalação ou configuração. |
|
|
O código QR foi digitalizado e aguarda confirmação no dispositivo móvel. |
|
|
Ativação bem-sucedida. O |
|
|
A sessão QR expirou. Crie uma nova sessão QR. |
|
|
O usuário negou a autorização ou cancelou a instalação. |
|
|
O gateway ou canal de terceiros retornou um erro irrecuperável. |
Erros
|
HTTP |
Tipo |
Código |
Gatilho |
|
401 |
|
|
PAT inválido ou expirado. |
|
404 |
|
|
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_secondsretornado na resposta de criação. -
Após
confirmed, atualize os detalhes do canal.