Desenvolvemos uma API para devolver informação sobre os códigos postais de Portugal.
Com esta API poderá obter informação sobre os códigos postais de Portugal, como por exemplo, o nome da localidade, o distrito e a região e integrar esta informação no seu sistema.
Para utilizar esta API, crie uma conta usando o formulário abaixo.
A API apenas tem um endpoint: /api/v1/<API-KEY>/<CP4>-<CP3>
API-KEY - A sua chave de acesso à API, enviada por email
CP4 - Os primeiros 4 digitos do código postal
CP3 - Os últimos 3 digitos do código postal, a seguir ao hifen
https://www.cttcodigopostal.pt/api/v1/aaa0011aaa0011aaa0011aaa0011/2520-193
200 OK e a informação sobre o código postal em formato JSON:
[
{
"morada": "Rua Engenheiro Carlos Alberto Guerreiro ",
"porta": "",
"localidade": "Baleal",
"freguesia": "Ferrel",
"concelho": "Peniche",
"distrito": "Leiria",
"latitude": "39.352983",
"longitude": "-9.3562203",
"codigo-postal": "2520-193",
"info-local": "Urbanização Baleal Sol Village II",
"codigo-arteria": "215980000",
"concelho-codigo": 14,
"distrito-codigo": 10
},
{
"morada": "Rua do Salgado ",
"porta": "",
"localidade": "Baleal",
"freguesia": "Ferrel",
"concelho": "Peniche",
"distrito": "Leiria",
"latitude": "39.3565342",
"longitude": "-9.3552865",
"codigo-postal": "2520-193",
"info-local": "Urbanização Baleal Sol Village II",
"codigo-arteria": "215990000",
"concelho-codigo": 14,
"distrito-codigo": 10
},
{
"morada": "Rua do Zimbral ",
"porta": "",
"localidade": "Baleal",
"freguesia": "Ferrel",
"concelho": "Peniche",
"distrito": "Leiria",
"latitude": "39.352983",
"longitude": "-9.3562203",
"codigo-postal": "2520-193",
"info-local": "Urbanização Baleal Sol Village II",
"codigo-arteria": "216000000",
"concelho-codigo": 14,
"distrito-codigo": 10
},
{
"morada": "Rua do Gorjão ",
"porta": "",
"localidade": "Baleal",
"freguesia": "Ferrel",
"concelho": "Peniche",
"distrito": "Leiria",
"latitude": "39.3658757",
"longitude": "-9.3173746",
"codigo-postal": "2520-193",
"info-local": "",
"codigo-arteria": "664410000",
"concelho-codigo": 14,
"distrito-codigo": 10
}
]400 Bad Request ou 500 Bad Request e a informação sobre o erro no body.