Dados abertos · API v1

Regras municipais, prontas a reutilizar.

A mesma informação verificada que alimenta o site e a calculadora, disponível em JSON, CSV e através de uma API versionada.

Abrir OpenAPI Descarregar dados

Endpoints

Contrato simples e previsível

Respostas cacheáveis incluem ETag. Erros usam sempre um código e uma mensagem. Valores monetários são cêntimos inteiros.

GET

/api/v1/municipalities

Municípios revistos e respetivas regras atuais

GET

/api/v1/municipalities/{slug}

Regra, fontes e metadados de um município

GET

/api/v1/municipalities/{slug}/history

Versões e alterações registadas

GET

/api/v1/rules/current

Todas as regras publicadas atuais

GET

/api/v1/updates

Atualizações recentes do conjunto de dados

POST

/api/v1/calculate

Cálculo auditável, noite a noite

Exemplo

Calcular uma estadia

curl https://portugalalojamento.com/api/v1/calculate \
  -H 'content-type: application/json' \
  -d '{"municipality":"lisboa","checkIn":"2026-09-01","checkOut":"2026-09-04","guests":[{"age":34},{"age":12}]}'