O que é o PTAPI?

Uma API para retornar informação sobre códigos postais.

O objectivo do PTAPI é disponibiliar o acesso a dados e informações de um código postal.
As informações disponibilizadas são: morada, localidade, freguesia, concelho, distrito, latitude e longitude.
A pesquisa pode ser feita atráves de um URL sendo retornado um ojecto JSON com a respectiva resposta.
A utiização so serviço só é possivel após registo. Preencha o formulário de registo e obtenho o seu AppID para utilização da API.

API

A PT é um web service REST-compliant, ou seja, utiliza o métodos tradicional GET.

  • /ptcp/v2 - retorna array com informação sobre código postal

  • URI: https://api.duminio.com/ptcp/v2/{AppID}/{0000000}
    {AppID} = O seu AppID recebido por email após registo
    {0000000} = codigo postal a obter informação

    Resposta:
    {
     "ID": int,
     "CodigoPostal": string,
     "Morada": string,
     "Localidade": string,
     "Freguesia": string,
     "Concelho": string,
     "CodigoDistrito": int,
     "Distrito": string,
     "Latitude": decimal,
     "Longitude": decimal
    }

    Exemplo:
    URI: https://api.duminio.com/ptcp/v2/ptapi5f137036cb7f95.53044711/2590432
    Resposta:
    [
    {
    "ID": 1,
    "CodigoPostal": "2590-432",
    "Morada": "Quinta da Bica",
    "Localidade": "Sapataria, Sobral de Monte Agraço, LisboaSizandros",
    "Freguesia": "Sapataria ",
    "Concelho": "Sobral de Monte Agraço",
    "CodigoDistrito": 11,
    "Distrito": "Lisboa",
    "Latitude": "38.997235",
    "Longitude": "-9.161673"
    },
    {
    "ID": 2,
    "CodigoPostal": "2590-432",
    "Morada": "Rua Santa Maria dos Sizandros",
    "Localidade": "Sapataria, Sobral de Monte Agraço, LisboaSizandros",
    "Freguesia": "Sapataria ",
    "Concelho": "Sobral de Monte Agraço",
    "CodigoDistrito": 11,
    "Distrito": "Lisboa",
    "Latitude": "38.964303",
    "Longitude": "-9.192121"
    },
    {
    "ID": 3,
    "CodigoPostal": "2590-432",
    "Morada": "Largo Rio da Bica",
    "Localidade": "Sapataria, Sobral de Monte Agraço, LisboaSizandros",
    "Freguesia": "Sapataria ",
    "Concelho": "Sobral de Monte Agraço",
    "CodigoDistrito": 11,
    "Distrito": "Lisboa",
    "Latitude": "38.964443",
    "Longitude": "-9.193397"
    },
    {
    "ID": 4,
    "CodigoPostal": "2590-432",
    "Morada": "Rua do Moínho",
    "Localidade": "Sapataria, Sobral de Monte Agraço, LisboaSizandros",
    "Freguesia": "Sobral de Monte Agraço ",
    "Concelho": "Sobral de Monte Agraço",
    "CodigoDistrito": 11,
    "Distrito": "Lisboa",
    "Latitude": "38.997235",
    "Longitude": "-9.161673"
    }
    ]

  • /ptcp - retorna informação sobre código postal(v1 - só retorna um elemento)

  • URI: https://api.duminio.com/ptcp/{AppID}/{0000000}
    {AppID} = O seu AppID recebido por email após registo
    {0000000} = codigo postal a obter informação

    Resposta:
    {
     "CodigoPostal": string,
     "Morada": string,
     "Localidade": string,
     "Freguesia": string,
     "Concelho": string,
     "CodigoDistrito": int,
     "Distrito": string,
     "Latitude": decimal,
     "Longitude": decimal
    }

    Exemplo:
    URI: https://api.duminio.com/ptcp/ptapi5f137036cb7f95.53044711/4000066
    Resposta:
    {
     "CodigoPostal": "4000066",
     "Morada": "Avenida dos Aliados",
     "Localidade": "PORTO",
     "Freguesia": "Santo Ildefonso",
     "Concelho": "Porto",
     "CodigoDistrito": 13,
     "Distrito": "Porto",
     "Latitude": 41.147978,
     "Longitude": -8.610862
    }

Registo

Preencha o formulário e receberá o seu AppID para utilização da API

Condições de Utilização

Este é um serviço gratuito e pode ser utilizador para qualquer fim.
Use o serviço de forma responsável.

Contacto

Para Sugestões ou comentários por favor preencha o formulário: