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.