> For the complete documentation index, see [llms.txt](https://bikeconecta.gitbook.io/api-bikeconecta/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bikeconecta.gitbook.io/api-bikeconecta/api-limitacoes-e-regras-de-consumo.md).

# API - Limitações e Regras de Consumo

**Visão Geral**\
Para garantir o bom funcionamento e a estabilidade da nossa plataforma, implementamos regras específicas de uso para a nossa API. Estas regras visam evitar sobrecarga e garantir que todos os usuários possam acessar os serviços de forma eficiente.

#### Proibição de Pulling

A prática de **pulling** — fazer requisições constantes à API para verificar se novos dados ou eventos estão disponíveis — não é permitida. A nossa API foi projetada para ser utilizada de forma eficiente, respondendo apenas às requisições necessárias, e não para ser consultada repetidamente em curtos intervalos de tempo.

Em vez de utilizar pulling, recomendamos fortemente a utilização dos nossos **webhooks** para receber notificações em tempo real sempre que eventos relevantes ocorrerem.

**Uso do Header `X-Webhook-Origin` para Prevenção de Disparos de Webhook**

Para evitar o disparo acidental de eventos de webhook pela própria API e garantir uma comunicação eficiente, recomendamos o uso do header `X-Webhook-Origin` com o valor `true` em chamadas onde o disparo de eventos de webhook deve ser ignorado. Este header é essencial para evitar notificações redundantes e prevenir loops de notificação.

Utilizar esse header como recomendado é essencial para garantir um fluxo otimizado de eventos e uma comunicação eficiente com nossa API.

#### Rate Limit (Limite de Requisições)

Para evitar abusos e manter a estabilidade do sistema, há um **rate limit** configurado para o uso da nossa API. Esse limite controla a quantidade de requisições que podem ser feitas dentro de um período de tempo. O limite atual é de `10 requisições por minuto.`

Se o limite for excedido, requisições adicionais serão bloqueadas temporariamente até que o período de tempo se renove.

Para evitar atingir o rate limit:

* Otimize suas requisições para que sejam feitas de forma eficiente.
* Evite fazer requisições desnecessárias.

Recomendamos fortemente a utilização de **webhooks** para garantir que seu sistema receba as informações necessárias sem a necessidade de consultas frequentes à API.