Changelog da API

Changelog da API Lojas Leve On

Estado atual

Versao atual: v1

Base publica para integradores:

texthttps://lojasleveon.com.br/api/v1

Sandbox publico para integradores:

texthttps://lojasleveon.com.br/api/v1/integracoes/sandbox

O sandbox publico exige X-API-Key com escopo sandbox:read.

A V1 esta liberada para integradores homologados em leitura, sandbox e webhooks assinados. Escritas genericas continuam bloqueadas por seguranca ate uma fase propria de homologacao.

Politica de compatibilidade

Dentro da mesma versao, a Lojas Leve On pode:

• Adicionar campos novos em respostas JSON.
• Adicionar endpoints novos.
• Adicionar eventos novos de webhook.
• Adicionar valores novos em campos de status.
• Melhorar mensagens de erro sem mudar o codigo HTTP.

Dentro da mesma versao, a Lojas Leve On nao deve:

• Remover campo existente sem aviso.
• Mudar o significado de campo existente.
• Remover endpoint usado em producao.
• Trocar autenticacao, assinatura HMAC ou regra de idempotencia sem janela de migracao.

Integradores devem ignorar campos desconhecidos e nunca depender da ordem dos campos JSON.

Avisos de mudanca

Mudancas sem quebra podem entrar direto no changelog.

Mudancas que podem quebrar integradores devem ter:

1. Registro neste changelog.
2. Prazo de migracao.
3. Nova versao ou campo alternativo.
4. Aviso ao responsavel tecnico cadastrado.
5. Monitoramento interno pela equipe Lojas Leve On.

Prazo recomendado:

Tipo de mudanca	Prazo minimo
Campo novo opcional	Sem prazo
Endpoint novo	Sem prazo
Evento webhook novo	Sem prazo
Campo deprecado	30 dias
Mudanca de contrato	60 dias
Remocao de endpoint	90 dias

Status dos recursos

Recurso	Status	Observacao
API Key por vendedor	Estavel	Liberada pela equipe apos solicitacao
Escopos de leitura	Estavel	Financeiro, extrato, pos-venda, produtos, pedidos, envio e NF-e
Sandbox	Estavel	Nao grava dados reais
Colecao Postman	Estavel	Disponivel em /api/docs/postman.json
OpenAPI JSON	Estavel	Disponivel em /api/docs/openapi.json
Webhooks HMAC	Estavel	Assinatura X-Llon-Signature
Eventos operacionais	Homologacao	Pedido criado, pedido pago, envio atualizado e NF-e autorizada
Semaforo de prontidao	Homologacao	Ajuda operador a liberar producao
Escrita de produtos	Bloqueado	Contrato existe, escrita real depende de flag
Escrita de estoque	Bloqueado	Contrato existe, escrita real depende de flag
Cancelamento por API	Bloqueado	Fluxo real continua auditado internamente

2026-08-16 - V1.4

Adicionado

• Pagina /api/docs/changelog.
• Politica publica de compatibilidade da API.
• Status por recurso: estavel, homologacao ou bloqueado.
• Homologacao guiada pela equipe Lojas Leve On, com checklist humano e revisao por vendedor.
• Caminhos alternativos para baixar colecao Postman:

- /api/docs/postman

- /api/docs/collection.json

Corrigido

• Download da colecao Postman validado no ambiente local.

2026-08-16 - V1.3

Adicionado

• Indicadores internos de prontidao para apoiar a liberacao de producao.
• Score por vendedor para apoiar liberacao de producao.
• Indicadores de API Key, sandbox, webhook, HTTPS, entrega 2xx e erros recentes.

2026-08-16 - V1.2

Adicionado

• Colecao Postman/Insomnia em /api/docs/postman.json.
• Bloco "Kit do integrador" na pagina /api/docs.
• Variaveis prontas: baseUrl, apiKey, sellerId, pedidoId, produtoId e webhookSecret.

2026-08-16 - V1.1

Adicionado

• Endpoint sandbox para simular assinatura HMAC:

textPOST /api/v1/integracoes/sandbox/webhooks/assinatura

• Checklist sandbox antes da producao.
• OpenAPI com rotas de sandbox, leitura, webhooks e contratos bloqueados de escrita.

2026-08-16 - V1.0

Adicionado

• Documentacao principal da API externa.
• API Key por vendedor.
• Escopos de leitura.
• Webhooks externos com assinatura HMAC.
• Eventos operacionais automaticos:

- pedido.created

- pedido.paid

- envio.status_changed

- nfe.authorized

Depreciacoes

Nao existe recurso depreciado na V1 neste momento.

Proxima fase planejada

Antes de liberar escrita real para integradores externos, ainda faltam:

• Tela de aprovacao explicita por integrador para escrita.
• Contrato completo de payload para criar/editar produto.
• Validacao profunda de imagens, estoque, dimensoes e categorias.
• Idempotencia obrigatoria testada em carga.
• Auditoria visual no detalhe da API Key.
• Ambiente sandbox publico separado, se o volume de integradores crescer.