YOM Docs

• Guias de integração
  • Formas de integração
    • Integração por API
    • Integração por arquivos
  • Entidades
    • Categorias
    • Centro de Distribuição
    • Comércios
    • Comodatos
    • Custo de entrega
    • Crédito
    • Documentos Fiscais
    • Limite de desconto
    • Pagamentos
    • Produtos
    • Promoções
    • Segmentos
    • Sobrescritas
    • Estoque
    • Supervisores
    • Transações
    • Vendedores
  • Webhooks
    • Requisitos técnicos
    • Webhooks do cliente para a YOM
      • Modificação de pedidos
      • Carga em massa de estoque
      • Modificação em massa de pedidos
    • Webhooks da YOM para o cliente
      • Pedidos
      • Pagamentos
      • Pedido mínimo
      • Preço de entrega
      • Devoluções
      • Comodatos
      • Criação de comércios
  • Changelog
  • API de Extração de Recomendações
    • Autenticação
    • Recomendações
    • Boas práticas
• Configurações

Boas práticas

A seguir estão listadas as boas práticas recomendadas para o consumo eficiente e seguro da API de Recomendações da YOM.

🔄 Consumo

• Reutilize o token durante sua janela de validade; não solicite um novo a cada request.
• Paginação: percorra as páginas usando page até que hasNext seja false. No endpoint por comércio você pode aumentar limit até 100; o endpoint de domínio devolve 500 por página.
• Cargas incrementais: ordene por -updatedAt e filtre do seu lado por data para trazer apenas o que é novo.
• Novas tentativas: diante de 429 e 5xx, tente novamente com espera exponencial.

🔒 Segurança

• Guarde o client_secret em um gerenciador de segredos.
• Não armazene o client_secret em repositórios, logs, tickets nem scripts compartilhados.
• Mantenha credenciais separadas por ambiente (Staging e Produção).
• Rotacione as credenciais diante de qualquer suspeita de exposição, entrando em contato com a YOM.

🆘 Suporte

Diante de qualquer dúvida de integração, problemas de acesso ou coordenação da passagem para Produção, entre em contato com a sua equipe de contrapartida na YOM.

📝 Controle de alterações

Etapas anteriores

<aside> <img src="/icons/arrow-left_gray.svg" alt="/icons/arrow-left_gray.svg" width="40px" />

Recomendações

</aside>

Próximas etapas

<aside> <img src="/icons/arrow-right_gray.svg" alt="/icons/arrow-right_gray.svg" width="40px" />

</aside>