Limites de taxa e paginação
Quantas requisições você pode fazer, os cabeçalhos que mostram onde você está e como percorrer coleções grandes.
Traduzido para sua conveniência. Código, nomes de campos e a referência da API continuam em inglês. Versão em inglês
Limites de taxa
Valem dois limites, ambos em janelas fixas de um minuto. O limite do espaço de trabalho cobre todas as requisições de API do espaço juntas (API REST com um token de API e a API compatível com Zendesk) e depende do seu plano:
| Plano | Requisições por minuto, espaço de trabalho inteiro |
|---|---|
| Free | Sem acesso à API |
| Starter | 200 |
| Growth | 400 |
| Pro | 700 |
| Enterprise | 2.500 |
Além disso, um único token de API pode fazer no máximo 700 requisições por minuto.
| Cabeçalho | Significado |
|---|---|
X-Rate-Limit, X-Rate-Limit-Remaining | O limite do espaço de trabalho e o que resta dele neste minuto |
X-RateLimit-Limit, X-RateLimit-Remaining | O mesmo para o token |
X-RateLimit-Reset | Segundos até a janela do token reiniciar |
Acima do limite você recebe 429 Too Many Requests com um cabeçalho Retry-After. Espere esses segundos e tente de novo. Aumente a espera exponencialmente se continuar recebendo 429.
Paginação
As coleções são por página: ?page=2&itemsPerPage=50, até 100 itens por página.
Para exportações e sincronizações, GET /api/tickets também aceita paginação por cursor, que se mantém consistente enquanto tickets são criados:
- Envie
?cursor=&limit=100(um cursor vazio) para a primeira página. - Siga
links.nextaté quemeta.has_moreseja false.
Os resultados são ordenados por id, que é a ordem de criação. A API compatível com Zendesk aceita os estilos do Zendesk: offset, cursor e exportação incremental.