WAZGO PUBLIC API · V1

Erros da API

Erros retornam um envelope uniforme e sanitizado, com requestId para correlação.

{
  "error": {
    "code": "INSUFFICIENT_SCOPE",
    "message": "A chave não possui o escopo necessário para esta operação.",
    "requestId": "request-id"
  }
}

HTTP	Códigos documentados	Descrição
400	INVALID_REQUEST, INVALID_CURSOR, IDEMPOTENCY_KEY_REQUIRED	Entrada ou cursor inválido, ou header obrigatório ausente.
401	UNAUTHORIZED	Bearer ausente, inválido, expirado ou revogado.
403	INSUFFICIENT_SCOPE, SUBSCRIPTION_INACTIVE, TRIAL_EXPIRED, FEATURE_NOT_AVAILABLE, PLAN_LIMIT_REACHED	Permissão, estado comercial, recurso ou quota.
404	NOT_FOUND, RESOURCE_NOT_FOUND	Rota ou recurso não disponível neste workspace.
409	IDEMPOTENCY_KEY_REUSED, IDEMPOTENCY_IN_PROGRESS	Conflito em retry de criação.
429	RATE_LIMITED	Rate limit atingido.
500	INTERNAL_ERROR	Falha interna sanitizada.

O estado comercial do workspace determina o código específico de erro para operações bloqueadas.