​

Limites e Erros

​

Códigos HTTP padronizados

​

Formato padrão dos erros

{
  "error": "codigo_legivel",
  "message": "Descricao humana do que aconteceu"
}

{
  "error": "limit_reached",
  "message": "Limite de entidades expostas atingido (5)",
  "limit": 5,
  "current": 5
}

​

Limites por plano

​

Rate limiting

• Throttle no cliente: não envie rajadas de chamadas — espalhe no tempo.
• Backoff exponencial ao receber 429: dobre o intervalo a cada tentativa.
• Use WebSocket para receber estados em tempo real em vez de polling agressivo.

import time
import requests

def call_with_backoff(method, url, **kwargs):
    delay = 1
    for attempt in range(6):
        resp = requests.request(method, url, **kwargs)
        if resp.status_code != 429:
            return resp
        time.sleep(delay)
        delay *= 2
    return resp

​

Erros específicos do POST /v1/service

​

Depurando

1. Confira a especificação: API Reference lista todos os endpoints com schemas.
2. Verifique o token: faca uma chamada simples (GET /v1/states) — se voltar 401, o problema e o token.
3. Verifique o contexto da org: se opera em organização, o header X-Organization-Id precisa estar correto e o usuário precisa ser membro.
4. Logs do painel: em Automações → Histórico você ve cada execução com trace passo-a-passo.