ConectZap · Documentação

Erros

Toda resposta de erro usa application/problem+json (RFC 9457):

{
  "type": "https://docs.conectzap.app/errors/instance_not_connected",
  "title": "Instância não conectada",
  "status": 409,
  "code": "instance_not_connected",
  "detail": "…",
  "requestId": "…",
  "errors": [{ "path": "…", "message": "…" }]
}

Quando tentar de novo

Repita só o que é transitório: 429, 503 e 500, além de 409 instance_paused e 409 conflict quando vierem com Retry-After. Respeite o Retry-After e use backoff exponencial com jitter. Nas operações que criam efeitos, mande a mesma Idempotency-Key na repetição para não duplicar. Os demais 4xx pedem correção da requisição. Veja Limites.

Códigos

CódigoStatusTítulo
validation_failed400Requisição inválida
unauthenticated401Não autenticado
forbidden403Acesso negado
not_found404Recurso não encontrado
method_not_allowed405Método não permitido
conflict409Conflito
plan_limit_reached409Limite do plano atingido
instance_not_connected409Instância não conectada
instance_paused409Instância em pausa
instance_busy429Instância ocupada
message_not_found404Mensagem não encontrada
idempotency_key_reused422Idempotency-Key reutilizada
rate_limited429Limite de requisições excedido
payload_too_large413Conteúdo grande demais
unsupported_media_type415Tipo de mídia não suportado
invalid_signature403Assinatura inválida
upload_expired410Prazo de envio expirado
already_uploaded409Arquivo já enviado
media_type_mismatch422Tipo de mídia divergente
media_not_found404Mídia não encontrada
media_unavailable—Mídia indisponível
media_fetch_failed—Falha ao baixar a mídia
voice_note_requires_ogg400Mensagem de voz exige OGG/Opus
provider_unavailable503Provedor indisponível
tenant_migrating503Migração em andamento
service_unavailable503Serviço indisponível
internal_error500Erro interno