Limites de requisições

Os limites são aplicados por workspace e por X-Client-Name:

limites

Sustained60 requisições por minuto

Burstaté 20 requisições em um segundo

Over the limit429 Too Many Requests com o cabeçalho Retry-After

Boas práticas

• Tente de novo com backoff. Em um 429, aguarde Retry-After segundos. Em 5xx, repita requisições idempotentes (GET, PUT, DELETE) com backoff exponencial e jitter.
• Agrupe as escritas. POST .../scheduled-visits aceita um roteiro inteiro em uma chamada: uma requisição para 50 visitas, não 50 requisições.
• Pagine com o tamanho máximo (size=200) ao ler coleções completas.
• Faça cache do que muda pouco, como redes, marcas e campos de pesquisa.
• Sincronize de forma incremental com since em vez de reler tudo.

Métodos HTTP

Métodos HTTP

GETLeitura

POSTCriação

PUTSubstituição (v1)

PATCHAtualiza somente os campos enviados (v3)

DELETEExclusão. Nunca recebe corpo; os IDs vão no caminho ou na query string.