API Províncias de Angola
Guia de migração
Visão geral
Esta página reúne o que você precisa ajustar na sua integração. A migração da v1 para a v2 é opcional, pois a v1 continua funcionando.
Migrando da v1 para a v2
Para migrar, troque o prefixo /api/v1 por /api/v2, traduza os caminhos e os campos conforme as tabelas abaixo e ajuste o formato da data de fundação.
Caminhos
| v1 | v2 |
|---|---|
| /provincias | /provinces |
| /capitais | /capitals |
| /municipios | /municipalities |
| /comunas | /communes |
| /distritos | /districts |
| /etnias | /ethnic-groups |
| /linguas | /languages |
| /angola | /angola |
Os caminhos aninhados seguem a mesma tradução. Por exemplo, /provincias/{província}/municipios/{município}/comunas passa a ser /provinces/{province}/municipalities/{municipality}/communes.
Por favor consulte a documentação de cada endpoint para verificar se há alterações adicionais nos parâmetros ou no formato das respostas.
Campos das respostas
| v1 | v2 |
|---|---|
| nome | name |
| extensao | area |
| data_fundacao | founded_at |
| provincia | province |
| provincias | provinces |
| municipio | municipality |
| municipios | municipalities |
| comunas | communes |
| distritos | districts |
| etnias | ethnic_groups |
| linguas | languages |
O endpoint /angola também traduz os campos (por exemplo, capital_principal passa a ser main_capital). Consulte a resposta de exemplo na página Angola com o seletor na versão desejada.
Por favor consulte a documentação de cada endpoint para verificar se há alterações adicionais nos parâmetros ou no formato das respostas.
Data de fundação
A data passa do formato 26-04-1980 para o formato ISO 8601, 1980-04-26.
Idioma das mensagens
As mensagens de sucesso e de erro da v2 continuam em português por padrão, então nada muda para quem compara o texto delas. Para recebê-las em inglês, envie o cabeçalho Accept-Language: en.