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 o valor da taxa de juros do BNA.
GET https://angolaapi.onrender.com/api/v1/banks/rates/interest/bna
// GET https://angolaapi.onrender.com/api/v1/banks/rates/interest/bna
{
"rate": "15,5%"
}
Retorna o valor da taxa interbancária de oferta de fundos do mercado de Luanda.
GET https://angolaapi.onrender.com/api/v1/banks/rates/interest/luibor
// GET https://angolaapi.onrender.com/api/v1/banks/rates/interest/luibor
{
"date": "10 de Setembro de 2020",
"rates": [
{
"maturity": "Overnight",
"rate": "5,38%"
},
{
"maturity": "3 Meses",
"rate": "12,35%"
},
{
"maturity": "12 Meses",
"rate": "16,14%"
}
]
}
Retorna o valor da taxa de inflação do Banco Nacional de Angola.
GET https://angolaapi.onrender.com/api/v1/banks/rates/inflation
// GET https://angolaapi.onrender.com/api/v1/banks/rates/inflation
{
"date": "14 de Fevereiro de 2021",
"status": "Dados referentes ao mês de Janeiro de 2021",
"rates": [
{
"type": "Inflação Mensal",
"rate": "1,50%"
},
{
"type": "Inflação Acumulada",
"rate": "1,50%"
},
{
"type": "Inflação Homóloga",
"rate": "24,41%"
}
]
}
Retorna as taxas de câmbio mais importantes do BNA.
GET https://angolaapi.onrender.com/api/v1/banks/rates/exchange
// GET https://angola-api.com/api/v1/banks/rates/exchange
{
"rates": [
{
"currency": "USD",
"rate": 635.762
},
{
"currency": "EUR",
"rate": 773.722
},
{
"currency": "ZAR",
"rate": 44.132
}
]
}
Retorna a cotação do dolar e euro nos principais bancos comerciais do país.
GET https://angolaapi.onrender.com/api/v1/banks/rates/comercial-exchange
// GET https://angolaapi.onrender.com/api/v1/banks/rates/comercial-exchange
{
"date": "25 de Fevereiro de 2021",
"banks": [
{
"name": "Banco de Investimento Rural - (BIR)",
"current": {
"buy": [
{
"currency": "USD/AOA",
"quotation": 572
},
{
"currency": "EUR/AOA",
"quotation": 712.07
}
],
"sell": [
{
"currency": "USD/AOA",
"quotation": 699
},
{
"currency": "EUR/AOA",
"quotation": 854.55
}
]
},
"lastDay": {
"buy": [
{
"currency": "USD/AOA",
"quotation": 595
},
{
"currency": "EUR/AOA",
"quotation": 715.31
}
],
"sell": [
{
"currency": "USD/AOA",
"quotation": 698
},
{
"currency": "EUR/AOA",
"quotation": 854.55
}
]
},
"variation": {
"buy": [
{
"currency": "USD/AOA",
"variation": "4,02%"
},
{
"currency": "EUR/AOA",
"variation": "0,46%"
}
],
"sell": [
{
"currency": "USD/AOA",
"variation": "-0,14%"
},
{
"currency": "EUR/AOA",
"variation": "0,00%"
}
]
}
},
...
]
Retorna o nome do banco, os dias e as taxas de juros de para depósitos a prazo efetuado pelos mesmos
GET https://angolaapi.onrender.com/api/v1/banks/rates/interest/term-deposit
// GET https://angolaapi.onrender.com/api/v1/banks/rates/interest/term-deposit
{
"date": "25 de Fevereiro de 2021",
"banks": [
{
"name": "Banco Millenium Atlântico - (ATL)",
"rates": [
{
"days": 30,
"rate": "3,50%"
},
{
"days": 90,
"rate": "5,00%"
},
{
"days": 360,
"rate": "7,00%"
}
]
},
{
"name": "Banco Angolano de Investimentos - (BAI)",
"rates": [
{
"days": 30,
"rate": "4,50%"
},
{
"days": 90,
"rate": "7,00%"
},
{
"days": 360,
"rate": "11,0%"
}
]
},
...
]
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/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 |
---|