Changelog
Back to All
Improved

Evolução da API de Produtos (Paginação por Cursor)

8 days ago by Angela Santos

A forma como o endpoint GET/produtos processa grandes volumes de dados foi atualizada! O modelo antigo, chamado Paginação por Offset (uso do parâmetro pagina), está sendo substituído pela Paginação por Cursor (uso do parâmetro produtoVarianteIdDe).

Essa evolução é necessária para garantir melhor performance e eliminar possíveis gargalos críticos durante as chamadas na API.

🚧

Atualização de parâmetros

  • pagina Deprecated
  • produtoVarianteIdDe Novo
  1. O que foi implementado?

  • Novo Parâmetro Liberamos o suporte total ao parâmetro produtoVarianteIdDe, permitindo que a integração "salte" diretamente para os próximos registros sem processar os anteriores.

  • Mensagem de erro orientativa: Caso a integração tente usar o modelo antigo acima do limite, o sistema retornará um erro 422 com instruções claras sobre o parâmetro correto a ser utilizado.

  1. Cronograma e Datas

A virada de chave está prevista para ocorrer em 17/08/2026.

  • Novas Lojas: Todas as lojas provisionadas a partir desta data já nascerão com o limite de paginação ativo por padrão.

  • Lojas Atuais: A data prevista para atualização é em 17/08/2026.

  1. Ganhos e Benefícios

A transição para o modelo de cursor traz resultados imediatos para a saúde da loja e do ecossistema:

  • Redução de Latência: Em cenários de consultas profundas (deep pagination), o tempo de resposta da API cai em até 94%.

  • Fim dos Timeouts: Lojistas com grandes inventários não sofrerão mais com quedas de conexão durante a sincronização de produtos.

  • Estabilidade do Banco de Dados: Reduzimos picos de processamento (CPU) no banco de dados em 90%, evitando que uma integração ineficiente prejudique a navegação dos consumidores na loja.

O que deve ser feito?

Para garantir que sua operação não seja afetada, você desenvolver e parceiro de tecnologia (ERP) deve seguir estes passos:

  • Revisar a Integração: Identificar onde o parâmetro pagina (offset) é utilizado nas chamadas de produtos.

  • Atualizar o Código: Alterar a lógica de busca. Em vez de incrementar o número da página, a integração deve passar a enviar o ID da última variante recebida no parâmetro produtoVarianteIdDe.

  • Testar: Validar se a integração continua recebendo todos os produtos corretamente sob o novo modelo de cursor.

  • Prazo Final: Concluir as alterações antes de 17/08/2026.