API Províncias de Angola

GitHub

Distritos

Introdução

Todas as requisições à API começam com a seguinte URL base: 

https://angolaprovinciasapi.ggwp.com.br/api/v1

Buscando todos os distritos do país

Este endpoint retorna as informações sobre todos os distritos do país: 

GET /distritos

Exemplo de consulta: 

// GET https://angolaprovinciasapi.ggwp.com.br/api/v1/distritos
{
"success": true,
"code": 200,
"message": "Sucesso",
"data": [
{
"nome": "Catete",
"slug": "catete",
"municipio": {
"nome": "Icolo e Bengo",
"slug": "icolo-e-bengo",
"provincia": {
"nome": "Luanda",
"slug": "luanda",
"extensao": "18.826 km²",
"data_fundacao": "25-01-1576"
}
}
},
//...
]
}

Buscando um determinado distrito

Para consultar um determinado distrito, utilize o seguinte endpoint: 

GET /distritos/{slug}

{slug} deve ser substituído pelo slug do distrito.

As informações de cada distrito podem ser acessadas através de um slug exclusivo que identifica o distrito. O slug está disponível na resposta da requisição que lista todos os distritos. Quando você faz uma requisição por ex. GET /distritos, a API no índice "data" retorna um array de objetos, e cada objeto contém o slug correspondente ao distrito.

Exemplo de consulta: 

// GET https://angolaprovinciasapi.ggwp.com.br/api/v1/distritos/catete
{
"success": true,
"code": 200,
"message": "Sucesso",
"data": {
"nome": "Catete",
"slug": "catete",
"municipio": {
"nome": "Icolo e Bengo",
"slug": "icolo-e-bengo",
"provincia": {
"nome": "Luanda",
"slug": "luanda",
"extensao": "18.826 km²",
"data_fundacao": "25-01-1576"
}
}
}
}