Meeventos

Tema Escuro

Limites de Requisições ​

Introdução ​

A API da Meeventos implementa limites de requisição para garantir uma distribuição equitativa dos recursos e manter a estabilidade e a disponibilidade do serviço para todos os usuários. Este documento detalha como esses limites são aplicados e como você pode monitorar seu uso.

Limites de Requisição ​

A API é limitada a 50 créditos por minuto por token de acesso. Cada requisição à API consome 1 crédito, independentemente do tipo de método utilizado.

Cabeçalhos de Resposta ​

Todas as respostas da nossa API incluem os seguintes cabeçalhos HTTP, que ajudam a gerenciar e entender o estado atual do seu limite de requisições:

  • Rate-Limit-Limit: O número total de créditos permitidos por minuto.
  • Rate-Limit-Remaining: O número de créditos que restam no período atual.
  • Rate-Limit-Reset: O número de segundos até que o contador de créditos seja reinicializado.

Excedendo os Limites ​

Caso o limite de créditos seja atingido, a API retornará um código de status HTTP 429 (Too Many Requests). Isso indica que você excedeu a capacidade permitida de requisições por minuto. A resposta incluirá o cabeçalho Rate-Limit-Reset, informando quantos segundos faltam até que o limite seja reinicializado.

Boas Práticas para Gerenciamento de Limites ​

Para evitar atingir o limite de créditos e garantir uma utilização eficiente da API, recomendamos as seguintes práticas:

  • Monitoramento Ativo: Acompanhe os cabeçalhos de limites nas respostas da API para ajustar sua frequência de requisições.
  • Implementação de Retry: Em casos de erro 429, implemente uma lógica de retry com um atraso igual ao valor indicado pelo Rate-Limit-Reset.
  • Distribuição Uniforme de Requisições: Tente distribuir suas requisições de forma uniforme ao longo do minuto para maximizar a disponibilidade dos seus créditos.

Conclusão ​

Entender e respeitar os limites de requisições é vital para o uso responsável da API da Meeventos. Estas medidas são projetadas para proteger tanto a sua aplicação quanto nossa infraestrutura, assegurando um serviço de alta disponibilidade para todos os usuários. Se você tiver dúvidas ou precisar de assistência adicional, por favor, entre em contato com nosso suporte.