Visão geral

A API possui duas versões, ambas disponíveis e com os mesmos dados. A versão é especificada no caminho da URL (ex.: /provinces ). Use o seletor v1 | v2 no topo da página para ver os endpoints e as respostas de exemplo de cada versão.

A v2 é a versão mais recente e a recomendada para novas integrações. A v1 continua funcionando sem alterações.

Diferenças entre v1 e v2

• Caminhos e campos em inglês: por exemplo, /provincias passa a ser /provinces e o campo nome passa a ser name.
• Datas no formato ISO 8601: a data de fundação passa de 26-04-1980 para 1980-04-26.
• Idioma das mensagens à escolha: as mensagens de sucesso e de erro da v2 continuam em português por padrão. Para recebê-las em inglês, envie o cabeçalho Accept-Language: en. A v1 responde sempre em português.
• Os dados são os mesmos: nomes e slugs continuam em português (ex.: Bié, bie).