Introducción
Rate Limit es el número máximo de solicitudes que una sola aplicación puede realizar en un período de tiempo determinado. Cuando la aplicación supera este límite, la solicitud de API fallará y devolverá un código de status HTTP 429.Estos límites nos ayudan a proporcionar la API que es confiable y escalable.En caso de error 429, revisa el comportamiento de tu aplicación
En muchos casos, una aplicación termina fallando cuando entra en un estado de looping debido a un bloqueo o un comportamiento inesperado. En caso de obtener este error, verifica si la aplicación realmente debería realizar tantas solicitudes en este endpoint. En este artículo, encontrarás algunas recomendaciones y buenas prácticas para usar nuestras API.
Módulos
Cada módulo/endpoint puede tener una política de límite de Rate Limit:Authentication
| Endpoint | Limite |
|---|---|
| POST /oauth/token | 20 req/min |
| POST /oauth/userCode | 20 req/min |
Order
| Endpoint | Limite |
|---|---|
| GET /events:polling | 6000 req/min |
| POST /events/acknowledgment | 6000 req/min |
| GET /orders/{id} | 3000 req/min |
| GET /orders/{id}/virtual-bag | 1000 req/s |
| POST /orders/{id}/confirm | 3000 req/min |
| POST /orders/{id}/startPreparation | 3000 req/min |
| POST /orders/{id}/readyToPickup | 3000 req/min |
| POST /orders/{id}/dispatch | 3000 req/min |
| POST /orders/{id}/requestCancellation | 300 req/min |
| POST /orders/{id}/requestDriver | 120 req/min |
| POST /orders/{id}/tracking | 5000 req/min |
| POST /order/v1.0/disputes/{disputeId}/accept | 1000 req/min |
| POST /order/v1.0/disputes/{disputeId}/reject | 1000 req/min |
| POST /order/v1.0/disputes/{disputeId}/alternatives/{alternativeId} | 1000 req/min |
Shipping
| Endpoint | Limite |
|---|---|
| GET /merchants/{merchantId}/deliveryAvailabilities | 4000 req/min |
| GET /orders/{orderId}/deliveryAvailabilities | 4000 req/min |
| POST /merchants/{merchantId}/order | 4000 req/min |
| POST /orders/{orderId}/requestDriver | 4000 req/min |
| POST /orders/{orderId}/cancel | 600 req/min |
| POST /orders/{orderId}/cancelRequestDriver | 600 req/min |
| POST /orders/{orderId}/userConfirmAddress | 500 req/min |
| POST /orders/{orderId}/deliveryAddressChangeRequest | 500 req/min |
| POST /orders/{orderId}/acceptDeliveryAddressChange | 500 req/min |
| POST /orders/{orderId}/denyDeliveryAddressChange | 500 req/min |
| GET /orders/{orderId}/safeDelivery | 500 req/min |
Merchant
| Endpoint | Limite |
|---|---|
| GET /merchants | 100 req/min |
| GET /merchants/{merchantId} | 300 req/min |
| GET /merchants/{merchantId}/status | 20000 req/min |
| GET /merchants/{merchantId}/interruptions | 100 req/min |
| POST /merchants/{merchantId}/interruptions | 200 req/min |
| DELETE /merchants/{merchantId}/interruptions/{interruptionId} | 100 req/min |
| GET /merchants/{merchantId}/opening-hours | 100 req/min |
| PUT /merchants/{merchantId}/opening-hours | 200 req/min |
Reviews
| Endpoint | Limite |
|---|---|
| GET /merchants/{merchantId}/reviews | 2000 req/min |
| GET /merchants/{merchantId}/reviews/{reviewId} | 2000 req/min |
| POST /merchants/{merchantId}/reviews/{reviewId}/answers | 2000 req/min |
| GET /merchants/{merchantId}/summary | 2000 req/min |
Financial
| Endpoint | Limite |
|---|---|
| GET /merchants/{merchantId}/sales | 1000 req/min |
| GET /merchants/{merchantId}/payments | 1000 req/min |
| GET /merchants/{merchantId}/paymentDetails | 1000 req/min |
| GET /merchants/{merchantId}/occurrences | 1000 req/min |
| GET /merchants/{merchantId}/maintenanceFees | 1000 req/min |
| GET /merchants/{merchantId}/incomeTaxes | 1000 req/min |
| GET /merchants/{merchantId}/periods?competence={competence} | 1000 req/min |
| GET /merchants/{merchantId}/chargeCancellations | 1000 req/min |
| GET /merchants/{merchantId}/cancellations | 1000 req/min |
| GET /merchants/{merchantId}/receivableRecords | 1000 req/min |
Catalog v1
| Endpoint | Limite |
|---|---|
| Todos los endpoints del módulo Catalog | 15000 req/min |
Catalog v2
| Endpoint | Limite |
|---|---|
| GET /merchants/{merchantId}/catalogs/{catalogId}/categories | 3000 req/min |
| POST /merchants/{merchantId}/catalogs/{catalogId}/categories | 3000 req/min |
| GET /merchants/{merchantId}/catalogs/{catalogId}/categories/{categoryId} | 3000 req/min |
| PATCH /merchants/{merchantId}/catalogs/{catalogId}/categories/{categoryId} | 3000 req/min |
| GET /merchants/{merchantId}/categories/{categoryId}/items | 3000 req/min |
| DELETE /merchants/{merchantId}/categories/{categoryId} | 3000 req/min |
| GET /merchants/{merchantId}/catalogs | 3000 req/min |
| GET /merchants/{merchantId}/catalogs/{catalogId}/unsellableItems | 3000 req/min |
| GET /merchants/{merchantId}/catalogs/{groupId}/sellableItems | 3000 req/min |
| GET /merchants/{merchantId}/catalogs/{catalogId}/changelog | 3000 req/min |
| GET /merchants/{merchantId}/catalog/version | 3000 req/min |
| GET /merchants/{merchantId}/products | 3000 req/min |
| POST /merchants/{merchantId}/products | 3000 req/min |
| PUT /merchants/{merchantId}/products/{productId} | 3000 req/min |
| DELETE /merchants/{merchantId}/products/{productId} | 3000 req/min |
| PATCH /merchants/{merchantId}/products/status | 5000 req/min |
| PATCH /merchants/{merchantId}/products/price | 5000 req/min |
| GET /merchants/{merchantId}/product/{productId} | 3000 req/min |
| GET /merchants/{merchantId}/products/externalCode/{externalCode} | 3000 req/min |
| DELETE /merchants/{merchantId}/categories/{categoryId}/products/{productId} | 3000 req/min |
| GET /merchants/{merchantId}/items/{itemId}/flat | 3000 req/min |
| PATCH /merchants/{merchantId}/item/price | 5000 req/min |
| PATCH /merchants/{merchantId}/item/status | 5000 req/min |
| PATCH /merchants/{merchantId}/item/externalCode | 3000 req/min |
| PUT /merchants/{merchantId}/items | 3000 req/min |
| GET /merchants/{merchantId}/optionGroups | 5000 req/min |
| DELETE /merchants/{merchantId}/optionGroups/{optionGroupId} | 3000 req/min |
| PATCH /merchants/{merchantId}/optionGroups/{optionGroupId} | 5000 req/min |
| DELETE /merchants/{merchantId}/optionGroups/{optionGroupId}/products/{productId} | 5000 req/min |
| PATCH /merchants/{merchantId}/optionGroups/{optionGroupId}/status | 5000 req/min |
| DELETE /merchants/{merchantId}/optionGroups/{optionGroupId}/products/{productId}/option | 5000 req/min |
| PATCH /merchants/{merchantId}/options/price | 5000 req/min |
| PATCH /merchants/{merchantId}/options/status | 5000 req/min |
| PATCH /merchants/{merchantId}/options/externalCode | 5000 req/min |
| GET /merchants/{merchantId}/batch/{batchId} | 5000 req/min |
| POST /merchants/{merchantId}/inventory | 5000 req/min |
| GET /merchants/{merchantId}/inventory/{productId} | 5000 req/min |
| POST /merchants/{merchantId}/inventory/batchDelete | 5000 req/min |
| POST /merchants/{merchantId}/version/upgrade | 3000 req/min |
| POST /merchants/{merchantId}/version/downgrade | 3000 req/min |
Logistics
| Endpoint | Limite |
|---|---|
| POST /logistics/v1.0/orders/{id}/assignDriver | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/goingToOrigin | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/arrivedAtOrigin | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/dispatch | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/arrivedAtDestination | 3000 req/min |
| POST /logistics/v1.0/orders/{id}/verifyDeliveryCode | 3000 req/min |
Picking
| Endpoint | Limit |
|---|---|
| POST /orders/{id}/startSeparation | 1000 req/s |
| POST /orders/{id}/endSeparation | 1000 req/s |
| POST /orders/{id}/items | 1000 req/s |
| PATCH /orders/{id}/items/{uniqueId} | 1000 req/s |
| DELETE /orders/{id}/items/{uniqueId} | 1000 req/s |