Access Policies

The calls to Marketplace’s API are ruled by access policies (policy rules). Those policies establish the quantity of requests may be performed for each of the available resources; also, they are very important to ensure a good performance of the API. Every time the calls limit is exceeded, the request receives a response with the HTTP 429 status (see the error codes here), with a message informing the exceeded quantity.

Instructions for development

The access policies prevent the API from having any call excess in a certain time limit, causing instability in the service providers. The limits are established according to the quantity of integrated merchants and the capacity of the servers providing the solution. In the same way, it’s also important that your application complies with the integration limits in order to avoid pooling. As soon as your application reaches the limit, or receives the first HTTP 429 error, wait the necessary time, so that the calls can be performed again.

The current limits of requests are the following:

 
In a sandbox environment:
 
Rule Max Rate (Error) Max Size (Error) Actions
PUT http://sandbox.extra.com.br/api/v1/sellerItems/{skuId}/stock/* 120 (HTTP 429) 1048576 (HTTP 413)
PUT http://sandbox.extra.com.br/api/v1/sellerItems/{skuId}/prices/* 120 (HTTP 429) 1048576 (HTTP 413)
GET http://sandbox.extra.com.br/api/v1/products/* 120 (HTTP 429) 1048576 (HTTP 413)
GET http://sandbox.extra.com.br/api/v1/categories/* 120 (HTTP 429) 1048576 (HTTP 413)
GET http://sandbox.extra.com.br/api/v1/loads/products/{importerInfoId}/{skuOrigin}/* 120 (HTTP 429) 1048576 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v1/sellerItems/skuOrigin/{skuOrigin}/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v1/sellerItems/{skuId}/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v1/sellerItems/* 2 (HTTP 429) 1024 (HTTP 413) 
POST http://sandbox.extra.com.br/api/v1/sellerItems/* 2 (HTTP 429) 1048576 (HTTP 413) 
POST http://sandbox.extra.com.br/api/v1/orders/{orderId}/ordersItems/trackings/* 120 (HTTP 429) 1048576 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v1/orders/status/approved/* 2 (HTTP 429) 1048576 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v1/orders/status/new/* 2 (HTTP 429) 1048576 (HTTP 413) 
POST http://sandbox.extra.com.br/api/v1/orders/status/approved/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v1/orders/* 60 (HTTP 429) 1048576 (HTTP 413) 
POST http://sandbox.extra.com.br/api/v1/orders/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v1 120 (HTTP 429) 1048576 (HTTP 413) 
POST http://sandbox.extra.com.br/api/v1 120 (HTTP 429) 10485760 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2/sellerItems/status/selling/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/sellerItems/status/selling/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2/sellerItems/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/sellerItems/* 2 (HTTP 429) 1024 (HTTP 413) 
POST http://sandbox.cnova.com/api/v2/loads/products/* 300 (HTTP 429) 1048576 (HTTP 413) 
DELETE http://sandbox.cnova.com/api/v2/loads/products/{skuSellerId}/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2/orders/status/new/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/orders/status/new/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2/orders/status/approved/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/orders/status/approved/* 2 (HTTP 429) 1024 (HTTP 413) 
(ANY) http://sandbox.extra.com.br/api/v2/orders/status/sent/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/orders/status/sent/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2/orders/status/partiallySent/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/orders/status/partiallySent/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2/orders/status/partiallyDelivered/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/orders/status/partiallyDelivered/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2/orders/status/delivered/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/orders/status/delivered/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2/orders/status/canceled/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/orders/status/canceled/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/orders/{orderId}/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.cnova.com/api/v2/tickets/* 1000 (HTTP 429) 1024 (HTTP 413) 
GET http://sandbox.extra.com.br/api/v2 120 (HTTP 429) 1024 (HTTP 413) 
(ANY) http://sandbox.cnova.com/api/v2 1000 (HTTP 429) 10485760 (HTTP 413) 
POST http://sandbox.extra.com.br/api/v2 120 (HTTP 429) 20971520 (HTTP 413) 
PUT http://sandbox.extra.com.br/api/v2 120 (HTTP 429) 20971520 (HTTP 413) 
POST http://sandbox.extra.com.br/api/v1/loads/* 1000 (HTTP 429) 1024 (HTTP 413) 
PUT http://sandbox.extra.com.br/api/v1/loads/* 1000 (HTTP 429) 1024 (HTTP 413) 
PUT http://sandbox.cnova.com/api/v2/orders/status/approved/{orderId}/* 2 (HTTP 429) 1024 (HTTP 413) 
PUT http://sandbox.cnova.com/api/v2/loads/sellerItems/stocks/* 3 (HTTP 429) 1024 (HTTP 413) 
POST http://sandbox.cnova.com/api/v2/tickets/* 1000 (HTTP 429) 1024 (HTTP 413)
 
In a production environment:
 
Rule Max Rate (Error) Max Size (Error) Actions 
POST http://api.cnova.com/api/v2/orders/{orderId}/trackings/sent/* 60 (HTTP 429) 1048576 (HTTP 413) 
POST http://api.cnova.com/api/v2/orders/{orderId}/trackings/delivered/* 60 (HTTP 429) 1048576 (HTTP 413) 
POST http://api.cnova.com/api/v2/orders/{orderId}/trackings/cancel/* 60 (HTTP 429) 1048576 (HTTP 413) 
POST http://api.cnova.com/api/v2/orders/{orderId}/trackings/return/* 60 (HTTP 429) 1048576 (HTTP 413) 
POST http://api.cnova.com/api/v2/orders/{orderId}/trackings/exchange/* 60 (HTTP 429) 1048576 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/{orderId}/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/status/new/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/status/approved/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/status/canceled/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/status/sent/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/status/delivered/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/status/partiallySent/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/status/partiallyDelivered/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/{orderId}/items/{skuSellerId}/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/orders/* 60 (HTTP 429) 1024 (HTTP 413) 
PUT http://api.cnova.com/api/v2/sellerItems/{skuSellerId}/stock/* 120 (HTTP 429) 1024 (HTTP 413) 
PUT http://api.cnova.com/api/v2/sellerItems/{skuSellerId}/prices/* 120 (HTTP 429) 1024 (HTTP 413) 
POST http://api.cnova.com/api/v2/viavarejo/sellerItems/viavarejo/prices/* 120 (HTTP 429) 1024 (HTTP 413) 
PUT http://api.cnova.com/api/v2/sellerItems/{skuSellerId}/status/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/sellerItems/{skuSellerId}/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/sellerItems/status/selling/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/sellerItems/* 60 (HTTP 429) 1024 (HTTP 413) 
PUT http://api.cnova.com/api/v2/loads/sellerItems/status/* 3 (HTTP 429) 18 (HTTP 413) 
PUT http://api.cnova.com/api/v2/loads/sellerItems/stocks/* 3 (HTTP 429) 18 (HTTP 413) 
PUT http://api.cnova.com/api/v2/loads/sellerItems/prices/* 3 (HTTP 429) 18 (HTTP 413) 
DELETE http://api.cnova.com/api/v2/loads/products/* 2 (HTTP 429) 1024 (HTTP 413) 
POST http://api.cnova.com/api/v2/orders/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/sites/* 300 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/warehouses/* 300 (HTTP 429) 1024 (HTTP 413) 
POST http://api.cnova.com/api/v2/loads/products/* 1 (HTTP 429) 10485760 (HTTP 413) 
POST http://api.extra.com.br/api/v1/loads/products/* 1 (HTTP 429) 10485760 (HTTP 413) 
GET http://api.cnova.com/api/v2/loads/products/{skuSellerId}/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/loads/products/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/products/{productId}/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/categories/* 10 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/warehouses/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2/tickets/* 120 (HTTP 429) 1024 (HTTP 413) 
POST http://api.cnova.com/api/v2/tickets/* 120 (HTTP 429) 1048576 (HTTP 413) 
PUT http://api.cnova.com/api/v2/tickets/{code}/status/* 120 (HTTP 429) 1048576 (HTTP 413) 
POST http://api.cnova.com/api/v2/tickets/{code}/messages/* 120 (HTTP 429) 1048576 (HTTP 413) 
PUT http://api.cnova.com/api/v2/tickets/{code}/assignee/* 120 (HTTP 429) 1048576 (HTTP 413) 
GET http://api.cnova.com/api/v2/tickets/{code}/messages/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://api.cnova.com/api/v2 300 (HTTP 429) 1024 (HTTP 413) 
POST http://api.cnova.com/api/v2 300 (HTTP 429) 1024 (HTTP 413) 
PUT http://api.extra.com.br/api/v1/loads/* 3 (HTTP 429) 1024 (HTTP 413) 
PUT http://api.extra.com.br/api/v1/sellerItems/{skuId}/stock/* 120 (HTTP 429) 1024 (HTTP 413) 
PUT http://api.extra.com.br/api/v1/sellerItems/{skuId}/prices/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/sellerItems/{skuId}/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/sellerItems/skuOrigin/{skuOrigin}/* 120 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/sellerItems/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/loads/products/{importerInfoId}/{skuOrigin}/* 300 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/loads/products/{importerInfoId}/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/products/* 2 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/categories/* 2 (HTTP 429) 1024 (HTTP 413) 
POST http://api.extra.com.br/api/v1/orders/{orderId}/ordersItems/trackings/* 60 (HTTP 429) 1048576 (HTTP 413) 
POST http://api.extra.com.br/api/v1/orders/{orderId}/ordersItems/status/canceled/* 60 (HTTP 429) 1048576 (HTTP 413) 
POST http://api.extra.com.br/api/v1/orders/{orderId}/status/canceled/* 60 (HTTP 429) 1048576 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/{orderId}/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/status/new/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/status/approved/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/status/canceled/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/status/sent/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/status/delivered/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/status/sentPartially/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/status/partiallyDelivered/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/tickets/* 60 (HTTP 429) 1024 (HTTP 413) 
GET http://api.extra.com.br/api/v1/orders/* 60 (HTTP 429) 1024 (HTTP 413) 
(ANY) http://api.extra.com.br/api/v2 (ANY) http://sandbox.extra.com.br/api/v2 1000 (HTTP 429) 1048576 (HTTP 413) 
(ANY) http://api.extra.com.br/api/v1 (ANY) http://sandbox.extra.com.br/api/v1 1000 (HTTP 429) 1048576 (HTTP 413) 
PUT http://api.cnova.com/api/v2/loads/products/{skuSellerId}/* 3 (HTTP 429) 1024 (HTTP 413)

 

English