Erros e limites
Erros
Todo erro vem no mesmo formato:
{ "error": { "code": "validation_failed", "message": "Payload inválido.", "details": [ { "field": "source", "message": "..." } ] } }
| Código | Significado |
|---|---|
invalid_key (401) | Chave ausente, errada, revogada ou expirada |
forbidden_scope (403) | A chave não tem permissão para esse tipo de registro |
origin_not_allowed (403) | Chave publicável usada em um site que não está autorizado |
ip_not_allowed (403) | Chave secreta usada de um IP fora da lista |
batch_not_allowed (403) | Lote com chave publicável |
field_not_allowed (403) | Chave publicável tentando usar um recurso restrito (overwrite, externalRef, owner, stage) |
feature_not_enabled (403) | O módulo de prospecção não está ativo na sua conta |
validation_failed (400) | Algum campo está inválido. Veja details |
consent_required (400) | A chave exige consent.accepted verdadeiro |
idempotency_key_reuse (422) | A mesma Idempotency-Key foi usada com dados diferentes |
rate_limited (429) | Muitas requisições. Aguarde o tempo de Retry-After |
Limites
- Chave secreta: 300 requisições por minuto, por padrão. Chave publicável: 30 por minuto, e 10 por minuto por IP. Os limites são configuráveis por chave.
- Um lote conta uma unidade por item.
- Toda resposta traz
X-RateLimit-Limit,X-RateLimit-RemainingeX-RateLimit-Reset. - Corpo de até 1 MB.