Introdução
As APIs do iFood permitem que parceiros utilizem diversos recursos da plataforma como gerenciar suas lojas e seus pedidos. O iFood oferece soluções para a operação e gestão das suas vendas como Gestor de Pedidos e Portal do Parceiro, mas a API permite integrar seu PDV/POS ou qualquer outro aplicativo à plataforma iFood.
Módulos da API
Authentication
Como autenticar para ter acesso aos outros módulos da API
Merchant
Detalhes e configurações das lojas
Order
Receba, confirme e acompanhe seus pedidos
Shipping
Sob Demanda: request IFood's delivery partners for orders taken external to the platform
Catalog
Configure o catálogo de produtos das suas lojas
Financial
Relatórios Financeiros e Conciliação
Review
Busque e responda a avaliações de pedidos
Groceries
Recursos exclusivos para mercados
Primeiros Passos
Utilizando as APIs
Tipo de Pedidos
Rate Limit
Rate Limit é o número máximo de requisições que um único aplicativo pode fazer em um determinado período de tempo. Quando o aplicativo excede esse limite, a solicitação da API falhará e retornará um código de status HTTP 429.
Esses limites nos ajudam a fornecer a API confiável e escalável.
Em caso de erro 429 revise o comportamento do seu aplicativo Em muitos casos, um aplicativo acaba sendo bloqueado quando entra em algum estado de looping por uma falha ou comportamento inesperado. Caso receba esse erro, verifique se o aplicativo realmente deveria estar fazendo tantas requisições nesse endpoint. Nesse artigo, você encontra algumas recomendações e boas práticas de uso das nossas APIs.
Cada módulo/endpoint pode ter uma política específica de rate limit:
Order
| Módulo | Endpoint | Limite |
|---|---|---|
| Order | GET /events:polling | 6000 req/min |
| Order | POST /events/acknowledgment | 6000 req/min |
| Order | GET /orders/{id} | 3000 req/min |
| Order | POST /orders/{id}/confirm | 3000 req/min |
| Order | POST /orders/{id}/startPreparation | 3000 req/min |
| Order | POST /orders/{id}/readyToPickup | 3000 req/min |
| Order | POST /orders/{id}/dispatch | 3000 req/min |
| Order | POST /orders/{id}/requestCancellation | 300 req/min |
| Order | POST /orders/{id}/requestDriver | 120 req/min |
| Order | POST /orders/{id}/tracking | 100 req/s |
Termos de Uso
Para utilizar a API e disponibilizar aplicativos, é necessário que o desenvolvedor leia e aceite os Termos de Uso do Usuário da API. E para utilizar os aplicativos, é necessário que o responsável pela loja aceite os Termos de Uso do Usuário de Aplicativos de Terceiros antes de conceder acesso aos seus dados através do aplicativo.