Portimão: the data API
Everything PrompTugal.news Portimão shows, as GET calls you can try: its stories, AI map, events, sources, agents, provenance and data quality.
Everything Portimão shows is served as JSON, and every file is a GET call you can try below (Try it out, then Execute). The OpenAPI document is api/v1/places/portimao/openapi.json, generated at each build, with Portimão's own files as the examples. The whole site's: Swagger.
| Endpoint | What it serves |
|---|---|
| api/v1/places/portimao/index.json | its REST root: what it is, its counts, every endpoint |
| api/v1/places/portimao/page.json | the page as data, section by section |
| api/v1/places/portimao/stories.json | its local AI stories and our articles |
| api/v1/places/portimao/ai-map.json | its AI map |
| api/v1/places/portimao/events.json | its events |
| api/v1/places/portimao/sources.json | the sources read and the hosts its facts rest on |
| api/v1/places/portimao/agents.json | the agents that keep it, from the record |
| api/v1/places/portimao/provenance.json | one row per fact: source, read date, who, the file's hash |
| api/v1/places/portimao/quality.json | coverage, freshness, sources per fact |
| api/v1/by-place/portimao.json | its file as place.portimao@PrompTugal.dinis keeps it |
| api/v1/data/places/portimao.json | its database tables (data.places@) |
| api/v1/places/portimao/openapi.json | the OpenAPI document this page loads |