Vamos transformar Angola em uma API?
Que tal pegarmos a ideia do Brasil API e levarmos em Angola?
Sobre o Projecto | Tecnologias | Endpoints | Como Contribuir | License | Colaboradores | Autores
Imagina um país com 1.246.700 km² com cerca de 30 milhões de habitantes distribuído em 18 províncias, mas não possui uma API pública para consulta de diversas informações sobre finanças, geografia ou validação de dados. Pois é, um grande problema.
Face a esse problema nos inspiramos na organização brasileira chamada Brasil Api e decidimos reunir o maior número de informações necessária sobre Angola e distribuir de forma gratuita.
Nós conseguimos distribuir algumas informações bancarias como :
- Taxa de juro do BNA
- Taxa de juro Luibor (Taxa Interbancária de Oferta de Fundos do Mercado de Luanda)
- Taxa de inflação
- Taxas de câmbio no BNA
- Taxas de câmbio nos bancos comerciais
- Taxas de juros de bancos comerciais
Também decidimos disponiblizar endpoints para validar as seguintes informações :
- Bilhete de identidade
- Passaporte
- Número de telefone
- Lista de provincias de Angola
- Lista de munícipios de uma província
- Lista de distritos de um munícipio
Este projecto foi construído usando as seguintes tecnologias:
Embaixo segue a lista e descrição de endpoints implementados nesse projecto. OBS: SSL está desabilitado nos endpoints.
Retorna a lista de províncias do território nacional ou apenas uma província se o ID for informado.
GET https://angolaapi.onrender.com/api/v1/geography/provinces
// GET https://angolaapi.onrender.com/api/v1/geography/provinces
[
{
"id": "6032c083c5686966bcc04202",
"nome": "Bengo",
"codigo": "BGO",
"capital": "Caxito",
"area": 15506,
"populacao": 356641,
"municipios": 6,
"comunas": 23
},
{
"id": "6032c083c5686966bcc04203",
"nome": "Benguela",
"codigo": "BGU",
"capital": "Benguela",
"area": 31788,
"populacao": 2231385,
"municipios": 10,
"comunas": 38
},
{
"id": "6032c083c5686966bcc04204",
"nome": "Bié",
"codigo": "BIE",
"capital": "Cuíto",
"area": 70314,
"populacao": 1455255,
"municipios": 9,
"comunas": 39
},
...
]GET https://angolaapi.onrender.com/api/v1/geography/provinces/[id]
// GET https://angolaapi.onrender.com/api/v1/geography/provinces/6032c083c5686966bcc04210
{
"id": "6032c083c5686966bcc04210",
"nome": "Moxico",
"codigo": "MOX",
"capital": "Luena",
"area": 223023,
"populacao": 758568,
"municipios": 9,
"comunas": 27
}Busca pelos munícipios de uma determinada província
GET https://angolaapi.onrender.com/api/v1/geography/county?provincia=[municipio]
// GET https://angolaapi.onrender.com/api/v1/geography/county?provincia=Luanda
[
{
"id": "6032c086c5686966bcc04270",
"descricao": "",
"nome": "Belas",
"provincia": "Luanda"
},
{
"id": "6032c086c5686966bcc04271",
"descricao": "",
"nome": "Cacuaco",
"provincia": "Luanda"
},
{
"id": "6032c086c5686966bcc04272",
"descricao": "",
"nome": "Cazenga",
"provincia": "Luanda"
},
{
"id": "6032c086c5686966bcc04273",
"descricao": "",
"nome": "Ícolo e Bengo",
"provincia": "Luanda"
},
{
"id": "6032c086c5686966bcc04274",
"descricao": "",
"nome": "Luanda",
"provincia": "Luanda"
},
{
"id": "6032c086c5686966bcc04275",
"descricao": "",
"nome": "Quilamba Quiaxi",
"provincia": "Luanda"
},
{
"id": "6032c086c5686966bcc04276",
"descricao": "",
"nome": "Quissama",
"provincia": "Luanda"
},
{
"id": "6032c086c5686966bcc04277",
"descricao": "",
"nome": "Talatona",
"provincia": "Luanda"
},
{
"id": "6032c086c5686966bcc04278",
"descricao": "",
"nome": "Viana",
"provincia": "Luanda"
}
]Verifica se número informado é um bilhete de identidade nacional.
GET https://angolaapi.onrender.com/api/v1/validate/bi/[bi]
// GET https://angolaapi.onrender.com/api/v1/validate/bi/006151112LA041
// Status: 200
{
"success": true,
"message": "This is an Angola valid bi number"
}// GET https://angolaapi.onrender.com/api/v1/validate/bi/006151112LA04A
// Status: 400
{
"success": false,
"message": "Invalid bi number"
}Retorna se o registo informado é aceitavél como identificador de um passaporte angolano.
GET https://angolaapi.onrender.com/api/v1/validate/passport/[passport]
// GET https://angolaapi.onrender.com/api/v1/validate/passport/n1234566
// Status: 200
{
"message": "This is an Angola valid passport number"
}// GET https://angolaapi.onrender.com/api/v1/validate/passport/n12345667
// Status: 400
{
"message": "Invalid passport number"
}Verifica se o número informado é de Angola e a qual operadora pertence.
GET https://angolaapi.onrender.com/api/v1/validate/phone/[phone]
// GET https://angolaapi.onrender.com/api/v1/validate/phone/+244923445618
// Status: 200
{
"message": "This is an Angola valid phone number",
"operator": "Unitel"
}// GET https://angolaapi.onrender.com/api/v1/validate/phone/+8599562562
// Status: 400
{
"message": "Invalid phone number"
}- Faça um Fork no projecto (https://github.com/Angola-Api/Angola-Api)
- Cria uma branch com a tua feature (
git checkout -b angolaapi/new-feature) - Faça um Commit com as tuas mudanças (
git commit -am 'Add new feature') - Faça um Push para a Branch (
git push origin feature/new-feature) - Cria uma Pull Request
Este projeto está sob a licença do MIT. Acessa: (https://opensource.org/licenses/MIT) para mais detalhes.
 @carlcr |
 @alexxfreitag |
|---|---|
 @ViniciusCarvalhoDev |
 @Nurul-GC |
 @luteroelavoco |
 @adilsonfuxe |
|---|