Início › API › Versionamento

Versionamento

Como a versão da API muda e o que o seu cliente precisa tolerar.

Abrir .md

A versão está no caminho: /v1.

  • Mudança compatível, sem aviso: campo novo na resposta ou valor novo num campo de texto livre. Seu cliente deve ignorar os campos que não conhece.
  • Mudança incompatível, com nova versão: remover um campo, renomear um campo ou mudar o tipo de um campo. Isso vira /v2, e o /v1 continua no ar durante a transição.

O contrato da versão atual está em https://api.toreva.com.br/v1/openapi.json.