Neste artigo, vamos explorar os limites de consumo da API do Omie, abordando as regras de Rate Limit e outras diretrizes para um uso eficiente e seguro dos recursos.
Entender esses limites e como eles impactam o desempenho das suas integrações é fundamental para garantir que sua aplicação funcione de forma otimizada e dentro dos parâmetros definidos pela Omie.
💡 Informações adicionais
Tópicos do Artigo:
Qual é o rate limit da API do Omie
1) Ao desenvolver e testar as APIs, você pode encontrar o erro "Too many requests". Esse erro ocorre quando algum dos limites de consumo é ultrapassado:
"429: Too many Requests"
2) Os limites de consumo da Omie, também chamados de Rate Limit, são:
960 requisições por minuto por Endereço IP;
240 requisições por minuto por Endereço IP + App Key + Método;
4 requisições simultâneas por Endereço IP + App Key + Método;
Alguns métodos têm restrições especiais, sendo limitados a uma requisição por vez.
⌚ Requisições redundantes liberadas a cada 60 segundos
⌚ Requisições redundantes liberadas a cada 60 segundos
Você pode consultar quantos registros diferentes forem necessários. No entanto, observe o seguinte:
Se tentar consultar o mesmo ID duas ou mais vezes dentro de um intervalo de 60 segundos, apenas a primeira requisição trará os dados.
As requisições subsequentes retornarão uma mensagem informando que a solicitação já foi realizada. Após os 60 segundos, a consulta será novamente permitida.
Dica: Recomendamos implementar um cache no lado da aplicação integrada para evitar essa situação e melhorar a eficiência.
🚫 API Bloqueada por consumo indevido
🚫 API Bloqueada por consumo indevido
Caso você consulte um método de forma repetida, pode ocorrer um erro.
Se ele não for tratado, na 10ª requisição incorreta para o mesmo Endereço IP + App Key + Método, ocorrerá um bloqueio de 30 minutos (HTTP 425), conforme exemplo abaixo:
💡 Critérios para a Restrição das APIs
💡 Critérios para a Restrição das APIs
Atualmente, o critério para a restrição das APIs é:
Restrição por IP + App Key + Método (distintos)
FAQ Rate Limit
1) Quantas requisições posso realizar por dia?
Atualmente, é possível realizar mais de 300.000 requisições por dia! Isso mesmo! Temos uma arquitetura que suporta o crescimento da sua empresa sem que você precise se preocupar!
Aqui temos uma tabela relacionando o tempo e o número de requisições:
Tempo | Número de Requisições |
Segundo | 4 |
Minuto* | 240 |
Hora | 14.400 |
Dia | 345.600 |
Semana | 2.419.200 |
Quinzena | 5.184.000 |
Mês |
|
*960 requisições por minuto (por Endereço IP)
2) Posso realizar duas requisições ao mesmo tempo?
Sim, é possível realizar duas requisições simultâneas, desde que lidem com registros diferentes.
💡 Por exemplo: você pode consultar, alterar ou incluir dados usando o mesmo método ao mesmo tempo, desde que cada requisição se refira a informações distintas. É importante apenas garantir que duas requisições não tentem acessar ou modificar o mesmo registro simultaneamente, para evitar erros de retorno da API.
3) Tenho mais de um aplicativo, posso realizar requisições com todos eles ao mesmo tempo?
Pode sim! Afinal, cada aplicativo tem a sua própria App Key, ou seja, o rate limit também é aplicado de forma separada em cada um deles
Isso significa que, se um aplicativo exceder o limite de requisições, não vai interferir na integração do outro aplicativo, pois são rotas diferentes que estão sendo consumidas!
4) No meu aplicativo tenho vários serviços integrados. Como funciona os limites?
Como cada aplicativo tem um Endereço de IP diferente, então em cada um o rate limit será aplicado de forma separada! Ou seja, eu posso ter dois aplicativos distintos consultando ao mesmo tempo, no meu aplicativo, a listagem dos produtos
As requisições enviadas por um, não vão interferir nas requisições enviadas pelo outro aplicativo, pois são rotas diferentes que estão sendo consumidas!
📚 Artigos Relacionados
