REST API for italian CAP database lookup
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci
.mvn/wrapper
client
server
.gitignore
LICENSE.txt
README.md
_config.yml
mvnw
mvnw.cmd
pom.xml

README.md

CAP Retrieve Interface CircleCI Docker Pulls

Simple REST API for italian CAP database lookup.

Semplice REST API per la ricerca all'interno del database dei CAP (codici di avviamento postale)

Data source

Current database is obtained from https://github.com/matteocontrini/comuni-json

Install

Install with docker

$ docker run -e 'SERVER_PORT=8080'-p 8080:8080 -d cloudesire/capri

webservice is now exposed on port 8080 (default port).

API

CAP Lookup

GET /cap/00195

Content-Type: application/json;charset=UTF-8

{
    "abbreviation": "RM", 
    "cities": [
        "Roma"
    ], 
    "province": "Roma", 
    "region": "Lazio"
}

Public best-effort service

An hosted instance is publicly available at https://capri.cloudesire.com, running on a Hetzner.de server.