Boas práticas de integração

Identificação e consulta

Prefira identificadores estáveis para vincular produtos e clientes. A API oferece consultas por identificador e por código em recursos como produtos e clientes.

Controle de volume

Utilize paginação quando disponível (per_page) e não repita consultas desnecessárias. Para operações em massa, considere os endpoints específicos de estoque e preços disponibilizados pela API.

Erros e reprocessamento

Valide os códigos HTTP e o campo de sucesso da resposta antes de considerar a operação concluída. Mantenha logs internos com horário, operação e identificador da requisição, sem registrar tokens ou dados pessoais em excesso.

Em caso de erro de rede em uma operação de escrita, verifique o resultado antes de repetir: nem todos os endpoints possuem chave de idempotência documentada.

Limites, webhooks e SLA

No código analisado, não identifiquei um contrato público geral de webhooks, de limite de requisições ou de SLA para toda a API V1. Esses contratos precisam de publicação específica antes de anunciarmos tais recursos a integradores.