O PTAPI não começou como uma plataforma de APIs. Começou com um problema simples: precisávamos de obter informação a partir de códigos postais portugueses e não encontrámos uma solução/API que respondesse à necessidade.
Os dados existiam. O desafio era integrá-los numa aplicação de forma simples: enviar um código postal e receber a informação necessária através de uma API.
Foi dessa necessidade concreta que nasceu o PTAPI.
Em julho de 2020 foi criada a API de Códigos Postais v1. O objetivo era simples: permitir consultar informação associada a um código postal português através de uma API REST, evitando que cada developer tivesse de construir e manter a sua própria solução.
Código Postal→PTAPI v1→1 resultadoA primeira versão devolvia apenas um registo por código postal. Funcionava nos casos mais básicos, mas rapidamente ficou claro que não representava corretamente a realidade: um mesmo código postal português pode estar associado a várias moradas.
Se a API devolvesse apenas uma delas, parte da informação ficava de fora. Era preciso evoluir.
A resposta foi repensada e nasceu rapidamente a API de Códigos Postais v2. Em vez de devolver apenas um registo, passou a devolver uma coleção de resultados associados ao código postal.
Código Postal→PTAPI v2→[ morada 1, morada 2, … ]A v2 tornou-se a base do serviço atual, disponibilizando morada, número de porta, localidade, freguesia, concelho, distrito e coordenadas geográficas.
O que começou por resolver uma necessidade concreta revelou-se útil para muitos outros developers. Desde 2020, milhares de aplicações utilizaram o PTAPI e milhões de pedidos foram processados.
A API de Códigos Postais v2 continua disponível, preservando a compatibilidade das integrações existentes.
O novo PTAPI deixa de ser pensado apenas como uma API de códigos postais. Estamos a preparar a plataforma para disponibilizar, brevemente, novos serviços e APIs orientados a dados portugueses.
Se existe um dado português que é difícil de integrar, talvez deva existir uma API simples para o fazer.
O princípio mantém-se igual ao que deu origem ao projeto em 2020: transformar necessidades reais de integração em APIs simples, úteis e fáceis de utilizar.