Versionamento

O endereço não carrega versão. Toda chamada é https://app.salos.com.br/api/<recurso> — sem /v1, sem /v2. É de propósito: endereço com número obriga você a re…

O endereço não carrega versão. Toda chamada é https://app.salos.com.br/api/<recurso> — sem /v1, sem /v2. É de propósito: endereço com número obriga você a reescrever a integração inteira no dia em que a versão mudar, e a integração que você escrever hoje não deve quebrar por causa disso.

  • Mudanças compatíveis (campo novo opcional, endpoint novo, evento novo) entram sem aviso e sem mudar nada pra você.
  • Trate campos desconhecidos como ignoráveis no seu cliente — é o que mantém sua integração funcionando quando adicionamos algo.
  • Mudanças incompatíveis (remover campo, mudar tipo, mudar significado), quando existirem, virão por um cabeçalho de data — Salos-Version: 2026-09-02 — e não por um endereço novo. O cabeçalho é opcional: não mandar nada significa "quero a versão atual", que é exatamente o que acontece hoje.
  • Descontinuação de versão é avisada com 6 meses de antecedência, por changelog e por e-mail aos administradores da conta.

⚠️ Hoje não existe versão nenhuma pra pedir. O nome do cabeçalho está reservado aqui para você saber por onde a mudança vai chegar; a API ainda não lê esse cabeçalho, e mandá-lo não muda resposta nenhuma.