{
 "openapi": "3.1.0",
 "info": {
  "title": "Public live cameras: where they are and whether they are up: data.promptugal.news",
  "version": "v0.1.47",
  "description": "Public live cameras in Lisboa and the Algarve from official operators (câmaras, Infraestruturas de Portugal, ports, airports, parks, public agencies, tourism boards) and operators' own public pages, each with operator, place, coordinates, terms and licence link, and an hourly check of whether its operator's page is up, with the history of changes. No frame, picture or stream is fetched, kept or analysed.\n\nPublisher: Each camera's operator, on its own page (register/cams.json lists them). Reuse terms: Official cameras of public bodies and operators' own pages only, by link; each camera's terms are recorded in register/cams.json (terms_page, terms_summary, licence_link). We ask for the operator's page only, once an hour, and keep only whether it answered and whether it still carries a player: never a frame, snapshot or stream, no face or plate recognition, no recording. Never an unsecured private camera. Take-down on request. Rules confirmed by Dinis Cruz on 18 November 2026, about 19:00 UTC (official cameras only; the operator's own embed or a link; never record; MEO BeachCam through its official embeds; Windy's webcams API under its terms, attributed). Not reviewed by a person. Not a warning service: follow IPMA and ANEPC.\n\nCode: Apache-2.0. Text: CC BY 4.0. The data keeps the terms of its own source (see each source card); nothing here relaxes them.",
  "license": {
   "name": "Apache-2.0 for code; each source keeps its own data terms",
   "identifier": "Apache-2.0"
  },
  "contact": {
   "name": "PrompTugal.news data",
   "url": "https://github.com/PrompTugal/PrompTugal__News__Data"
  }
 },
 "servers": [
  {
   "url": "https://data.promptugal.news",
   "description": "Production"
  }
 ],
 "externalDocs": {
  "description": "How to use the API",
  "url": "https://data.promptugal.news/api/"
 },
 "paths": {
  "/api/v1/cams/latest.json": {
   "get": {
    "operationId": "get_cams_latest",
    "tags": [
     "cams"
    ],
    "summary": "Public live cameras: where they are and whether they are up: the latest read",
    "description": "Public live cameras in the places we cover, from official operators only, each with its operator, place, coordinates, terms and licence link, and whether its operator's page is up. Status comes from the operator's page only; no frame, picture or stream is fetched, kept or analysed. Watch each camera on its operator's page.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "source": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "read_at": {
           "type": "string"
          },
          "provenance": {
           "type": "object",
           "properties": {
            "source": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "by": {
             "type": "string"
            },
            "terms": {
             "type": "string"
            },
            "register": {
             "type": "string"
            }
           },
           "required": [
            "source",
            "page",
            "read_at",
            "by",
            "terms",
            "register"
           ]
          },
          "about": {
           "type": "string"
          },
          "counts": {
           "type": "object",
           "properties": {
            "cameras": {
             "type": "integer"
            },
            "up": {
             "type": "integer"
            },
            "down": {
             "type": "integer"
            },
            "not_checked": {
             "type": "integer"
            },
            "places": {
             "type": "integer"
            },
            "pages_asked": {
             "type": "integer"
            }
           },
           "required": [
            "cameras",
            "up",
            "down",
            "not_checked",
            "places",
            "pages_asked"
           ]
          },
          "rules": {
           "type": "array",
           "items": {
            "type": "string"
           }
          },
          "by_place": {
           "type": "object",
           "properties": {
            "lisboa": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "portimao": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "faro": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "castro-marim": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "lagoa": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "silves": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "albufeira": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "loule": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "lagos": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "aljezur": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "vila-do-bispo": {
             "type": "array",
             "items": {
              "type": "string"
             }
            }
           },
           "required": [
            "lisboa",
            "portimao",
            "faro",
            "castro-marim",
            "lagoa",
            "silves",
            "albufeira",
            "loule",
            "lagos",
            "aljezur",
            "vila-do-bispo"
           ]
          },
          "cameras": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "id": {
              "type": "string"
             },
             "name": {
              "type": "string"
             },
             "place": {
              "type": "string"
             },
             "municipality": {
              "type": "string"
             },
             "lat": {
              "type": "number"
             },
             "lon": {
              "type": "number"
             },
             "coords_from": {
              "type": "string"
             },
             "operator": {
              "type": "string"
             },
             "operator_kind": {
              "type": "string"
             },
             "page": {
              "type": "string",
              "format": "uri"
             },
             "embed": {
              "type": "null"
             },
             "embed_allowed": {
              "type": "boolean"
             },
             "embed_basis": {
              "type": [
               "null",
               "string"
              ]
             },
             "check_note": {
              "type": [
               "null",
               "string"
              ]
             },
             "terms_page": {
              "type": [
               "string",
               "null"
              ],
              "format": "uri"
             },
             "terms_summary": {
              "type": "string"
             },
             "license": {
              "type": "object",
              "properties": {
               "name": {
                "type": "string"
               },
               "url": {
                "type": "string",
                "format": "uri"
               },
               "holder": {
                "type": "string"
               }
              },
              "required": [
               "name",
               "url",
               "holder"
              ]
             },
             "state": {
              "type": "string"
             },
             "http": {
              "type": [
               "integer",
               "null"
              ]
             },
             "checked_at": {
              "type": "string"
             },
             "since": {
              "type": "string"
             },
             "checks": {
              "type": "integer"
             },
             "up_checks": {
              "type": "integer"
             },
             "history": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "at": {
                 "type": "string"
                },
                "state": {
                 "type": "string"
                },
                "http": {
                 "type": [
                  "integer",
                  "null"
                 ]
                }
               },
               "required": [
                "at",
                "state",
                "http"
               ]
              }
             },
             "provenance": {
              "type": "object",
              "properties": {
               "listed_from": {
                "type": "string",
                "format": "uri"
               },
               "listed_by": {
                "type": "string"
               },
               "listed_at": {
                "type": "string"
               },
               "register": {
                "type": "string",
                "format": "uri"
               },
               "status_how": {
                "type": "string"
               },
               "status_at": {
                "type": "string"
               },
               "status_by": {
                "type": "string"
               },
               "licence": {
                "type": "string",
                "format": "uri"
               },
               "terms_checked": {
                "type": [
                 "string",
                 "null"
                ]
               }
              },
              "required": [
               "listed_from",
               "listed_by",
               "listed_at",
               "register",
               "status_how",
               "status_at",
               "status_by",
               "licence",
               "terms_checked"
              ]
             }
            },
            "required": [
             "id",
             "name",
             "place",
             "municipality",
             "lat",
             "lon",
             "coords_from",
             "operator",
             "operator_kind",
             "page",
             "embed",
             "embed_allowed",
             "embed_basis",
             "check_note",
             "terms_page",
             "terms_summary",
             "license",
             "state",
             "http",
             "checked_at",
             "since",
             "checks",
             "up_checks",
             "history",
             "provenance"
            ]
           }
          },
          "not_listed": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "name": {
              "type": "string"
             },
             "url": {
              "type": "string",
              "format": "uri"
             },
             "reason": {
              "type": "string"
             }
            },
            "required": [
             "name",
             "url",
             "reason"
            ]
           }
          },
          "gaps": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "host": {
              "type": "string"
             },
             "reason": {
              "type": "string"
             }
            },
            "required": [
             "host",
             "reason"
            ]
           }
          }
         },
         "required": [
          "source",
          "title",
          "read_at",
          "provenance",
          "about",
          "counts",
          "rules",
          "by_place",
          "cameras",
          "not_listed",
          "gaps"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "source": "cams",
           "title": "Public live cameras: where they are and whether they are up",
           "read_at": "2026-11-18T19:14:28Z",
           "provenance": {
            "source": "https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/register/cams.json",
            "page": "https://data.promptugal.news/sources/cams/",
            "read_at": "2026-11-18T19:14:28Z",
            "by": "sources/cams/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
            "terms": "Official cameras of public bodies and operators' own pages only, by link; each camera's terms are recorded in register/cams.json (terms_page, terms_summary, licence_link). We ask for the operator's page only, once an hour, and keep only whether it answered and whether it still carries a player: neve...",
            "register": "register/cams.json"
           },
           "about": "Public live cameras in the places we cover, from official operators only, each with its operator, place, coordinates, terms and licence link, and whether its operator's page is up. Status comes from the operator's page only; no frame, picture or stream is fetched, kept or analysed. Watch each camera...",
           "counts": {
            "cameras": 22,
            "up": 3,
            "down": 0,
            "not_checked": 19,
            "places": 11,
            "pages_asked": 2
           },
           "rules": [
            "Official cameras only; the operator's own embed (an iframe from the operator's host) or a link; never record (Dinis, 18 Nov 2026, about 19:00 UTC)",
            "MEO BeachCam included through its official camera pages; embed_allowed is true only where MEO's terms or official offer allow it",
            "Windy webcams API allowed under its terms, attributed; no key held, API not called"
           ],
           "by_place": {
            "lisboa": [
             "lisboa-tejo-live-cacilhas",
             "lisboa-tejo-live-vts"
            ],
            "portimao": [
             "portimao-praia-da-rocha-ondas",
             "portimao-praia-da-rocha-meo",
             "portimao-praia-do-vau"
            ],
            "faro": [
             "faro-praia-de-faro-oeste",
             "faro-ilha-do-farol",
             "faro-praia-de-faro-este"
            ],
            "castro-marim": [
             "castro-marim-praia-verde",
             "castro-marim-praia-da-alagoa"
            ],
            "lagoa": [
             "lagoa-carvoeiro"
            ],
            "silves": [
             "silves-armacao-de-pera"
            ],
            "albufeira": [
             "albufeira-praia-da-gale",
             "albufeira-praia-do-peneco"
            ],
            "loule": [
             "loule-vilamoura"
            ],
            "lagos": [
             "lagos-meia-praia"
            ],
            "aljezur": [
             "aljezur-monte-clerigo"
            ],
            "vila-do-bispo": [
             "vila-do-bispo-sagres",
             "vila-do-bispo-cordoama"
            ]
           },
           "cameras": [
            {
             "id": "lisboa-tejo-live-cacilhas",
             "name": "Tejo Live, Câmara Cacilhas",
             "place": "lisboa",
             "municipality": "Almada (view covers Lisboa)",
             "lat": 38.687,
             "lon": -9.15,
             "coords_from": "approximate from the named place",
             "operator": "APL Administração do Porto de Lisboa (Tejo Live)",
             "operator_kind": "port",
             "page": "https://www.portodelisboa.pt/tejo-live",
             "embed": null,
             "embed_allowed": false,
             "embed_basis": null,
             "check_note": null,
             "terms_page": "https://www.portodelisboa.pt/politica-de-privacidade",
             "terms_summary": "Page footer: '© APL Administração do Porto de Lisboa'. No linking or embedding terms found on the page. Page says the feed is about 30 seconds behind and that no image or sound is recorded or stored.",
             "license": {
              "name": "the operator's terms",
              "url": "https://www.portodelisboa.pt/politica-de-privacidade",
              "holder": "APL Administração do Porto de Lisboa (Tejo Live)"
             },
             "state": "up",
             "http": 200,
             "checked_at": "2026-11-18T19:14:28Z",
             "since": "2026-11-18T18:55:16Z",
             "checks": 5,
             "up_checks": 5,
             "history": [
              {
               "at": "2026-11-18T18:55:16Z",
               "state": "up",
               "http": 200
              }
             ],
             "provenance": {
              "listed_from": "https://www.portodelisboa.pt/tejo-live",
              "listed_by": "data.b.collector@PrompTugal.dinis (Sonnet), for data.b@PrompTugal.dinis",
              "listed_at": "2026-11-18T00:00:00Z",
              "register": "https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/register/cams.json",
              "status_how": "one GET of the operator page (HTML only; bytes dropped; no frame or stream)",
              "status_at": "2026-11-18T19:14:28Z",
              "status_by": "sources/cams/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
              "licence": "https://www.portodelisboa.pt/politica-de-privacidade",
              "terms_checked": "2026-11-18T00:00:00Z"
             }
            },
            {
             "id": "lisboa-tejo-live-vts",
             "name": "Tejo Live, Câmara VTS",
             "place": "lisboa",
             "municipality": "Oeiras (view covers Lisboa)",
             "lat": 38.7,
             "lon": -9.23,
             "coords_from": "approximate from the named place",
             "operator": "APL Administração do Porto de Lisboa (Tejo Live)",
             "operator_kind": "port",
             "page": "https://www.portodelisboa.pt/tejo-live",
             "embed": null,
             "embed_allowed": false,
             "embed_basis": null,
             "check_note": null,
             "terms_page": "https://www.portodelisboa.pt/politica-de-privacidade",
             "terms_summary": "Page footer: '© APL Administração do Porto de Lisboa'. No linking or embedding terms found on the page. Page says the feed is about 30 seconds behind and that no image or sound is recorded or stored.",
             "license": {
              "name": "the operator's terms",
              "url": "https://www.portodelisboa.pt/politica-de-privacidade",
              "holder": "APL Administração do Porto de Lisboa (Tejo Live)"
             },
             "state": "up",
             "http": 200,
             "checked_at": "2026-11-18T19:14:28Z",
             "since": "2026-11-18T18:55:16Z",
             "checks": 5,
             "up_checks": 5,
             "history": [
              {
               "at": "2026-11-18T18:55:16Z",
               "state": "up",
               "http": 200
              }
             ],
             "provenance": {
              "listed_from": "https://www.portodelisboa.pt/tejo-live",
              "listed_by": "data.b.collector@PrompTugal.dinis (Sonnet), for data.b@PrompTugal.dinis",
              "listed_at": "2026-11-18T00:00:00Z",
              "register": "https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/register/cams.json",
              "status_how": "one GET of the operator page (HTML only; bytes dropped; no frame or stream)",
              "status_at": "2026-11-18T19:14:28Z",
              "status_by": "sources/cams/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
              "licence": "https://www.portodelisboa.pt/politica-de-privacidade",
              "terms_checked": "2026-11-18T00:00:00Z"
             }
            },
            {
             "id": "portimao-praia-da-rocha-ondas",
             "name": "Ondas em Direto, Praia da Rocha",
             "place": "portimao",
             "municipality": "Portimão",
             "lat": 37.119,
             "lon": -8.536,
             "coords_from": "approximate from the named place",
             "operator": "Agrupamento de Escolas Manuel Teixeira Gomes (AEMTG), with the support of Câmara Municipal de Portimão",
             "operator_kind": "public agency",
             "page": "https://meteorologia.aemtg.pt/video",
             "embed": null,
             "embed_allowed": false,
             "embed_basis": null,
             "check_note": null,
             "terms_page": null,
             "terms_summary": "No terms, licence or embedding information found on the page.",
             "license": {
              "name": "the operator's terms",
              "url": "https://meteorologia.aemtg.pt/video",
              "holder": "Agrupamento de Escolas Manuel Teixeira Gomes (AEMTG), with the support of Câmara Municipal de Portimão"
             },
             "state": "up",
             "http": 200,
             "checked_at": "2026-11-18T19:14:28Z",
             "since": "2026-11-18T18:55:16Z",
             "checks": 5,
             "up_checks": 5,
             "history": [
              {
               "at": "2026-11-18T18:55:16Z",
               "state": "up",
               "http": 200
              }
             ],
             "provenance": {
              "listed_from": "https://meteorologia.aemtg.pt/video",
              "listed_by": "data.b.collector@PrompTugal.dinis (Sonnet), for data.b@PrompTugal.dinis",
              "listed_at": "2026-11-18T00:00:00Z",
              "register": "https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/register/cams.json",
              "status_how": "one GET of the operator page (HTML only; bytes dropped; no frame or stream)",
              "status_at": "2026-11-18T19:14:28Z",
              "status_by": "sources/cams/collect.mjs (code, no model; run by data.b@PrompTugal.dinis)",
              "licence": "https://meteorologia.aemtg.pt/video",
              "terms_checked": null
             }
            }
           ],
           "not_listed": [
            {
             "name": "SkylineWebcams (Lagos, Faro and others)",
             "url": "https://www.skylinewebcams.com/en/terms-of-use.html",
             "reason": "Terms read. They say nothing on linking or listing from other sites. Sharing is allowed only through its own share buttons and links; embedding is allowed with its Embed code unmodified; scraping and republishing are banned. Cameras are privately run (for example a restaurant). Not listed."
            },
            {
             "name": "Albufeira Praia dos Pescadores (hotel), Lagos Porto de Mos (restaurant), Martinhal, Carvoeiro videosurveillance",
             "url": "https://postal.pt/algarve/praia-do-carvoeiro-vai-ter-sistema-de-videovigilancia/",
             "reason": "Private business cameras on aggregator sites, or non-public surveillance. Operator's own public page not found."
            },
            {
             "name": "Windy webcams",
             "url": "https://api.windy.com/webcams/terms",
             "reason": "Allowed by Dinis under its terms, attributed, but there is no key and the API was not called, so no Windy camera is listed. Needs and terms are in the README."
            }
           ],
           "gaps": [
            {
             "host": "beachcam.meo.pt",
             "reason": "403 on fetch in pass one; not retried, as instructed. The terms page (https://beachcam.meo.pt/termos-e-condicoes/) and every camera page were therefore not read; wording comes from search snippets only. Whether MEO has any embed offer is unknown."
            },
            {
             "host": "www.cm-lisboa.pt",
             "reason": "403 on fetch (pass one)"
            },
            {
             "host": "www.portugalresident.com",
             "reason": "403 on fetch (pass one)"
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/cams/reads.json": {
   "get": {
    "operationId": "get_cams_reads",
    "tags": [
     "cams"
    ],
    "summary": "Public live cameras: where they are and whether they are up: every read, newest first",
    "description": "Every run of sources/cams/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "about": {
           "type": "string"
          },
          "source": {
           "type": "string"
          },
          "runs": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "at": {
              "type": "string"
             },
             "finished": {
              "type": "string"
             },
             "ok": {
              "type": "integer"
             },
             "failed": {
              "type": "integer"
             },
             "reads": {
              "type": "array",
              "items": {
               "type": "object",
               "properties": {
                "name": {
                 "type": "string"
                },
                "url": {
                 "type": "string",
                 "format": "uri"
                },
                "at": {
                 "type": "string"
                },
                "status": {
                 "type": "integer"
                },
                "bytes": {
                 "type": "integer"
                },
                "sha256_prefix": {
                 "type": "string"
                },
                "changed": {
                 "type": [
                  "boolean",
                  "string"
                 ]
                }
               },
               "required": [
                "name",
                "url",
                "at",
                "status",
                "bytes",
                "sha256_prefix",
                "changed"
               ]
              }
             }
            },
            "required": [
             "at",
             "finished",
             "ok",
             "failed",
             "reads"
            ]
           }
          }
         },
         "required": [
          "about",
          "source",
          "runs"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "about": "Every run of sources/cams/collect.mjs, newest first: each request's address, HTTP status, size, the first 16 hex of its sha256, and whether the bytes changed since the run before. The bytes and the full sha256 go to the source's vault (see card.json: latest/reads-full.json), never to git.",
           "source": "cams",
           "runs": [
            {
             "at": "2026-11-18T19:14:28Z",
             "finished": "2026-11-18T19:14:33Z",
             "ok": 2,
             "failed": 0,
             "reads": [
              {
               "name": "page-lisboa-tejo-live-cacilhas",
               "url": "https://www.portodelisboa.pt/tejo-live",
               "at": "2026-11-18T19:14:30Z",
               "status": 200,
               "bytes": 181620,
               "sha256_prefix": "5bf2440994a3398f",
               "changed": true
              },
              {
               "name": "page-portimao-praia-da-rocha-ondas",
               "url": "https://meteorologia.aemtg.pt/video",
               "at": "2026-11-18T19:14:32Z",
               "status": 200,
               "bytes": 2745,
               "sha256_prefix": "3710253342d218f4",
               "changed": false
              }
             ]
            },
            {
             "at": "2026-11-18T19:10:02Z",
             "finished": "2026-11-18T19:10:07Z",
             "ok": 2,
             "failed": 0,
             "reads": [
              {
               "name": "page-lisboa-tejo-live-cacilhas",
               "url": "https://www.portodelisboa.pt/tejo-live",
               "at": "2026-11-18T19:10:04Z",
               "status": 200,
               "bytes": 181620,
               "sha256_prefix": "8b23ef790a450f5c",
               "changed": true
              },
              {
               "name": "page-portimao-praia-da-rocha-ondas",
               "url": "https://meteorologia.aemtg.pt/video",
               "at": "2026-11-18T19:10:06Z",
               "status": 200,
               "bytes": 2745,
               "sha256_prefix": "3710253342d218f4",
               "changed": false
              }
             ]
            },
            {
             "at": "2026-11-18T19:06:29Z",
             "finished": "2026-11-18T19:06:34Z",
             "ok": 2,
             "failed": 0,
             "reads": [
              {
               "name": "page-lisboa-tejo-live-cacilhas",
               "url": "https://www.portodelisboa.pt/tejo-live",
               "at": "2026-11-18T19:06:31Z",
               "status": 200,
               "bytes": 181620,
               "sha256_prefix": "59499b9ac11c6706",
               "changed": true
              },
              {
               "name": "page-portimao-praia-da-rocha-ondas",
               "url": "https://meteorologia.aemtg.pt/video",
               "at": "2026-11-18T19:06:34Z",
               "status": 200,
               "bytes": 2745,
               "sha256_prefix": "3710253342d218f4",
               "changed": false
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/cams/card.json": {
   "get": {
    "operationId": "get_cams_card",
    "tags": [
     "cams"
    ],
    "summary": "Public live cameras: where they are and whether they are up: the card",
    "description": "Who publishes the source, its reuse terms, the schedule, who owns it, what runs by code, by agents and by people, and the vault.",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "object",
         "properties": {
          "id": {
           "type": "string"
          },
          "title": {
           "type": "string"
          },
          "what": {
           "type": "string"
          },
          "publisher": {
           "type": "string"
          },
          "owner": {
           "type": "string"
          },
          "collector": {
           "type": "string"
          },
          "source_home": {
           "type": "string"
          },
          "reader_page": {
           "type": "string"
          },
          "schedule": {
           "type": "object",
           "properties": {
            "cadence": {
             "type": "string"
            },
            "how": {
             "type": "string"
            }
           },
           "required": [
            "cadence",
            "how"
           ]
          },
          "terms": {
           "type": "object",
           "properties": {
            "summary": {
             "type": "string"
            },
            "page": {
             "type": "string"
            },
            "read_at": {
             "type": "string"
            },
            "republish": {
             "type": "string"
            },
            "open_question": {
             "type": "string"
            }
           },
           "required": [
            "summary",
            "page",
            "read_at",
            "republish",
            "open_question"
           ]
          },
          "api": {
           "type": "object",
           "properties": {
            "latest": {
             "type": "string"
            },
            "reads": {
             "type": "string"
            },
            "card": {
             "type": "string"
            },
            "openapi": {
             "type": "string"
            },
            "page": {
             "type": "string"
            }
           },
           "required": [
            "latest",
            "reads",
            "card",
            "openapi",
            "page"
           ]
          },
          "vault": {
           "type": "null"
          },
          "split": {
           "type": "object",
           "properties": {
            "code": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "agents": {
             "type": "array",
             "items": {
              "type": "string"
             }
            },
            "people": {
             "type": "array",
             "items": {
              "type": "string"
             }
            }
           },
           "required": [
            "code",
            "agents",
            "people"
           ]
          },
          "cost": {
           "type": "object",
           "properties": {
            "per_run_tokens": {
             "type": "integer"
            },
            "per_run_model_cost_usd": {
             "type": "integer"
            },
            "runner": {
             "type": "string"
            },
            "build_tokens": {
             "type": "string"
            },
            "note": {
             "type": "string"
            }
           },
           "required": [
            "per_run_tokens",
            "per_run_model_cost_usd",
            "runner",
            "build_tokens",
            "note"
           ]
          },
          "since": {
           "type": "string"
          },
          "vault_note": {
           "type": "string"
          }
         },
         "required": [
          "id",
          "title",
          "what",
          "publisher",
          "owner",
          "collector",
          "source_home",
          "reader_page",
          "schedule",
          "terms",
          "api",
          "vault",
          "split",
          "cost",
          "since",
          "vault_note"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "id": "cams",
           "title": "Public live cameras: where they are and whether they are up",
           "what": "Public live cameras in Lisboa and the Algarve from official operators (câmaras, Infraestruturas de Portugal, ports, airports, parks, public agencies, tourism boards) and operators' own public pages, each with operator, place, coordinates, terms and licence link, and an hourly check of whether its op...",
           "publisher": "Each camera's operator, on its own page (register/cams.json lists them)",
           "owner": "data.b@PrompTugal.dinis",
           "collector": "sources/cams/collect.mjs",
           "source_home": "https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/register/cams.json",
           "reader_page": "https://data.promptugal.news/sources/cams/",
           "schedule": {
            "cadence": "hourly",
            "how": "the Pages workflow (.github/workflows/pages.yml) at 17 and 47 minutes past each hour and on every push; one GET of each operator page a run"
           },
           "terms": {
            "summary": "Official cameras of public bodies and operators' own pages only, by link; each camera's terms are recorded in register/cams.json (terms_page, terms_summary, licence_link). We ask for the operator's page only, once an hour, and keep only whether it answered and whether it still carries a player: neve...",
            "page": "https://github.com/PrompTugal/PrompTugal__News__Data/blob/dev/register/cams-README.md",
            "read_at": "2026-11-18",
            "republish": "metadata and status only, with a link to the operator's page; the picture stays on the operator's page",
            "open_question": "Windy's webcams API needs a key: Dinis to make one if wanted (we do not sign up for services)."
           },
           "api": {
            "latest": "https://data.promptugal.news/api/v1/cams/latest.json",
            "reads": "https://data.promptugal.news/api/v1/cams/reads.json",
            "card": "https://data.promptugal.news/api/v1/cams/card.json",
            "openapi": "https://data.promptugal.news/api/v1/cams/openapi.json",
            "page": "https://data.promptugal.news/sources/cams/"
           },
           "vault": null,
           "split": {
            "code": [
             "the collector asks each camera's operator page once a run, records up, down or page up without a player, and keeps the changes",
             "GitHub Actions runs it and deploys the site"
            ],
            "agents": [
             "data.b.collector@PrompTugal.dinis (Sonnet) researched the cameras and their terms (register/cams.json) on 18 November 2026; data.b@PrompTugal.dinis wrote the collector and this card and reviewed the register"
            ],
            "people": [
             "Dinis Cruz asked for the live cameras site and decided its rules on 18 November 2026 (board/guidance/2026-11-18-people-blogs-cyber-and-simulated-payments.md and 2026-11-18-cameras-provenance-and-bulletins.md); no person has checked the cameras or values yet (not reviewed)"
            ]
           },
           "cost": {
            "per_run_tokens": 0,
            "per_run_model_cost_usd": 0,
            "runner": "GitHub Actions on a public repository: no charge; one request per operator page a run",
            "build_tokens": "not measured",
            "note": "Code only: no model is called when the data is collected."
           },
           "since": "2026-11-18",
           "vault_note": "No vault: the operator pages' bytes are dropped after each check; only the status is kept."
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/cams/openapi.json": {
   "get": {
    "operationId": "get_cams_openapi",
    "tags": [
     "cams"
    ],
    "summary": "Public live cameras: where they are and whether they are up: this document",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "tags": [
  {
   "name": "cams",
   "description": "Public live cameras in Lisboa and the Algarve from official operators (câmaras, Infraestruturas de Portugal, ports, airports, parks, public agencies, tourism boards) and operators' own public pages, each with operator, place, coordinates, terms and licence link, and an hourly check of whether its operator's page is up, with the history of changes. No frame, picture or stream is fetched, kept or analysed."
  }
 ],
 "x-source": {
  "id": "cams",
  "card": "https://data.promptugal.news/api/v1/cams/card.json",
  "page": "https://data.promptugal.news/sources/cams/"
 }
}
