Políticas de Acesso

As chamadas à API do Marketplace são reguladas por políticas de acesso (policy rules). Essas políticas definem a quantidade de requisições que podem ser realizadas para cada um dos recursos disponíveis e são muito importantes para garantir o bom desempenho da API. Toda vez que o limite de chamadas é excedido, a requisição é respondida com o status HTTP 429 (veja os códigos de erro aqui) acompanhado de uma mensagem informando a quantidade excedida.

Orientações para desenvolvimento

As políticas de acesso garantem que a API não sofra com excesso de chamadas em um determinado limite de tempo, causando instabilidade nos provedores do serviço. Os limites são estabelecidos de acordo com a quantidade de lojistas integrados e a capacidade dos servidores que estão provendo a solução. Da mesma forma, também é importante que sua aplicação observe os limites de integração para evitar poolings. Assim que sua aplicação atingir o limite, ou receber o primeiro erro HTTP 429, aguarde o tempo necessário para que as chamadas possam voltar a ser realizadas.

Os atuais limites de requisições são os seguintes

 
Em ambiente de sandbox:
 
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)
 
Em ambiente de produção:
 
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)

 

Português, Brasil