Referência da APIInstancias
Poll do QR Code e status (alternativa robusta ao SSE)
Retorna o snapshot atual do QR Code e do status da instancia. Diferente do stream SSE, cada requisicao e curta e independente, atravessando antivirus e proxies corporativos que bufferizam streams (a causa mais comum de o QR Code nao aparecer). Recomendado: faca polling a cada ~2 segundos ate connected ser true. Autentica pelo header Authorization normal (nao usa token de query).
Authorization
bearerAuth AuthorizationBearer <token>
API key enviada como Authorization Bearer pzk_live_... ou pzk_test_...
In: header
Path Parameters
id*string
Identificador da instancia.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/instances/cm5x8a9k20001abc123def456/qr/poll"{
"connected": false,
"qr": {
"code": "2@abc123...",
"at": "2026-06-03T10:30:00Z"
}
}{
"error": {
"code": "UNAUTHORIZED",
"message": "API key ausente ou invalida"
}
}{
"error": {
"code": "FORBIDDEN",
"message": "Projeto inativo ou sem permissao"
}
}{
"error": {
"code": "NOT_FOUND",
"message": "Instancia nao encontrada"
}
}