{
 "openapi": "3.1.0",
 "info": {
  "title": "Flights around Faro airport: data.promptugal.news",
  "version": "v0.1.47",
  "description": "Aircraft seen within 40 nautical miles of Faro airport: airline flights by callsign, airline and type; every other aircraft only counted.\n\nPublisher: adsb.lol (community ADS-B receivers). Reuse terms: adsb.lol: its API data is licensed under the Open Database License (ODbL 1.0): share-alike, with attribution; no key needed up to 500 requests a day per address. 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/adsb-faro/latest.json": {
   "get": {
    "operationId": "get_adsb_faro_latest",
    "tags": [
     "adsb-faro"
    ],
    "summary": "Flights around Faro airport: the latest read",
    "description": "What adsb.lol's community receivers saw within 40 nautical miles of Faro airport at the time read. Airline flights (an ICAO airline code and a flight number as callsign) by callsign; every other aircraft only counted. Coverage depends on volunteers' receivers: absence here is not proof an aircraft was not there.",
    "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"
            },
            "licence": {
             "type": "string"
            }
           },
           "required": [
            "source",
            "page",
            "read_at",
            "by",
            "terms",
            "licence"
           ]
          },
          "about": {
           "type": "string"
          },
          "airport": {
           "type": "object",
           "properties": {
            "icao": {
             "type": "string"
            },
            "name": {
             "type": "string"
            },
            "lat": {
             "type": "number"
            },
            "lon": {
             "type": "number"
            },
            "within_nm": {
             "type": "integer"
            }
           },
           "required": [
            "icao",
            "name",
            "lat",
            "lon",
            "within_nm"
           ]
          },
          "feed_time_ms": {
           "type": "integer"
          },
          "counts": {
           "type": "object",
           "properties": {
            "airline": {
             "type": "integer"
            },
            "other_aircraft": {
             "type": "integer"
            },
            "other_on_ground": {
             "type": "integer"
            },
            "by_airline": {
             "type": "object",
             "properties": {
              "RUK": {
               "type": "integer"
              }
             },
             "required": [
              "RUK"
             ]
            },
            "by_altitude_band": {
             "type": "object",
             "properties": {
              "30,000 ft and above": {
               "type": "integer"
              }
             },
             "required": [
              "30,000 ft and above"
             ]
            }
           },
           "required": [
            "airline",
            "other_aircraft",
            "other_on_ground",
            "by_airline",
            "by_altitude_band"
           ]
          },
          "airline": {
           "type": "array",
           "items": {
            "type": "object",
            "properties": {
             "callsign": {
              "type": "string"
             },
             "airline_icao": {
              "type": "string"
             },
             "type": {
              "type": "string"
             },
             "alt_ft": {
              "type": "integer"
             },
             "on_ground": {
              "type": "boolean"
             },
             "ground_speed_kt": {
              "type": "number"
             },
             "track_deg": {
              "type": "number"
             },
             "lat": {
              "type": "number"
             },
             "lon": {
              "type": "number"
             }
            },
            "required": [
             "callsign",
             "airline_icao",
             "type",
             "alt_ft",
             "on_ground",
             "ground_speed_kt",
             "track_deg",
             "lat",
             "lon"
            ]
           }
          }
         },
         "required": [
          "source",
          "title",
          "read_at",
          "provenance",
          "about",
          "airport",
          "feed_time_ms",
          "counts",
          "airline"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "source": "adsb-faro",
           "title": "Flights around Faro airport",
           "read_at": "2026-11-18T19:14:25Z",
           "provenance": {
            "source": "https://api.adsb.lol/v2/point/37.0144/-7.9659/40",
            "page": "https://globe.adsb.lol/?lat=37.014&lon=-7.966&zoom=9",
            "read_at": "2026-11-18T19:14:25Z",
            "by": "sources/adsb-faro/collect.mjs (code, no model; run by data@PrompTugal.dinis)",
            "terms": "adsb.lol: its API data is licensed under the Open Database License (ODbL 1.0): share-alike, with attribution; no key needed up to 500 requests a day per address.",
            "licence": "ODbL 1.0 (adsb.lol)"
           },
           "about": "What adsb.lol's community receivers saw within 40 nautical miles of Faro airport at the time read. Airline flights (an ICAO airline code and a flight number as callsign) by callsign; every other aircraft only counted. Coverage depends on volunteers' receivers: absence here is not proof an aircraft w...",
           "airport": {
            "icao": "LPFR",
            "name": "Faro airport",
            "lat": 37.0144,
            "lon": -7.9659,
            "within_nm": 40
           },
           "feed_time_ms": 1795029265500,
           "counts": {
            "airline": 1,
            "other_aircraft": 0,
            "other_on_ground": 0,
            "by_airline": {
             "RUK": 1
            },
            "by_altitude_band": {
             "30,000 ft and above": 1
            }
           },
           "airline": [
            {
             "callsign": "RUK3EV",
             "airline_icao": "RUK",
             "type": "B738",
             "alt_ft": 36025,
             "on_ground": false,
             "ground_speed_kt": 454.1,
             "track_deg": 6.7,
             "lat": 36.41,
             "lon": -7.81
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/adsb-faro/reads.json": {
   "get": {
    "operationId": "get_adsb_faro_reads",
    "tags": [
     "adsb-faro"
    ],
    "summary": "Flights around Faro airport: every read, newest first",
    "description": "Every run of sources/adsb-faro/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/adsb-faro/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": "adsb-faro",
           "runs": [
            {
             "at": "2026-11-18T19:14:25Z",
             "finished": "2026-11-18T19:14:25Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "point-lpfr",
               "url": "https://api.adsb.lol/v2/point/37.0144/-7.9659/40",
               "at": "2026-11-18T19:14:25Z",
               "status": 200,
               "bytes": 806,
               "sha256_prefix": "257eb60e3902c4d9",
               "changed": true
              }
             ]
            },
            {
             "at": "2026-11-18T19:09:59Z",
             "finished": "2026-11-18T19:09:59Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "point-lpfr",
               "url": "https://api.adsb.lol/v2/point/37.0144/-7.9659/40",
               "at": "2026-11-18T19:09:59Z",
               "status": 200,
               "bytes": 779,
               "sha256_prefix": "892598d0935287e2",
               "changed": true
              }
             ]
            },
            {
             "at": "2026-11-18T19:06:26Z",
             "finished": "2026-11-18T19:06:27Z",
             "ok": 1,
             "failed": 0,
             "reads": [
              {
               "name": "point-lpfr",
               "url": "https://api.adsb.lol/v2/point/37.0144/-7.9659/40",
               "at": "2026-11-18T19:06:26Z",
               "status": 200,
               "bytes": 1487,
               "sha256_prefix": "8d59b2fbf73c5790",
               "changed": true
              }
             ]
            }
           ]
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/adsb-faro/card.json": {
   "get": {
    "operationId": "get_adsb_faro_card",
    "tags": [
     "adsb-faro"
    ],
    "summary": "Flights around Faro airport: 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"
            },
            "quote": {
             "type": "string"
            },
            "quote_lang": {
             "type": "string"
            },
            "republish": {
             "type": "string"
            },
            "privacy": {
             "type": "string"
            }
           },
           "required": [
            "summary",
            "page",
            "read_at",
            "quote",
            "quote_lang",
            "republish",
            "privacy"
           ]
          },
          "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": "object",
           "properties": {
            "id": {
             "type": "string"
            },
            "name": {
             "type": "string"
            },
            "endpoint": {
             "type": "string"
            },
            "read_key": {
             "type": "string"
            },
            "clone": {
             "type": "string"
            },
            "layout": {
             "type": "string"
            },
            "note": {
             "type": "string"
            },
            "created": {
             "type": "string"
            },
            "by": {
             "type": "string"
            }
           },
           "required": [
            "id",
            "name",
            "endpoint",
            "read_key",
            "clone",
            "layout",
            "note",
            "created",
            "by"
           ]
          },
          "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"
          }
         },
         "required": [
          "id",
          "title",
          "what",
          "publisher",
          "owner",
          "collector",
          "source_home",
          "reader_page",
          "schedule",
          "terms",
          "api",
          "vault",
          "split",
          "cost",
          "since"
         ],
         "x-inferred": true
        },
        "examples": {
         "example": {
          "summary": "A real file, cut to a readable size",
          "value": {
           "id": "adsb-faro",
           "title": "Flights around Faro airport",
           "what": "Aircraft seen within 40 nautical miles of Faro airport: airline flights by callsign, airline and type; every other aircraft only counted.",
           "publisher": "adsb.lol (community ADS-B receivers)",
           "owner": "data@PrompTugal.dinis",
           "collector": "sources/adsb-faro/collect.mjs",
           "source_home": "https://api.adsb.lol/v2/point/37.0144/-7.9659/40",
           "reader_page": "https://globe.adsb.lol/?lat=37.014&lon=-7.966&zoom=9",
           "schedule": {
            "cadence": "hourly",
            "how": "the Pages workflow (.github/workflows/pages.yml), on a schedule at 17 minutes past each hour, and on every push to dev"
           },
           "terms": {
            "summary": "adsb.lol: its API data is licensed under the Open Database License (ODbL 1.0): share-alike, with attribution; no key needed up to 500 requests a day per address.",
            "page": "https://www.adsb.lol/docs/open-data/api/",
            "read_at": "2026-11-17",
            "quote": "license: ODbL 1.0 ... no key: 500 requests/day per IP",
            "quote_lang": "en",
            "republish": "yes, under ODbL 1.0 (attribution, share-alike for the database)",
            "privacy": "Our own rule, from the storm site: only airline callsigns are kept; other aircraft (private, military, unidentified) are counted, never listed."
           },
           "api": {
            "latest": "https://data.promptugal.news/api/v1/adsb-faro/latest.json",
            "reads": "https://data.promptugal.news/api/v1/adsb-faro/reads.json",
            "card": "https://data.promptugal.news/api/v1/adsb-faro/card.json",
            "openapi": "https://data.promptugal.news/api/v1/adsb-faro/openapi.json",
            "page": "https://data.promptugal.news/sources/adsb-faro/"
           },
           "vault": {
            "id": "sd1fblzs",
            "name": "promptugal-data-adsb-faro",
            "endpoint": "https://dev.send.sgraph.ai",
            "read_key": "sgit_public_read_dd88c305ed7763ba851800f41315e623d8e0443da1a10f80f4128ef9b1c58863",
            "clone": "sgit clone sgit_public_read_dd88c305ed7763ba851800f41315e623d8e0443da1a10f80f4128ef9b1c58863:sd1fblzs",
            "layout": "latest/<file> (the bytes as received, overwritten each run), <yyyy>/<mm>/<dd>/<hh>/<file>-<hhmmss>.json (a dated copy only when the bytes changed), latest/reads.json",
            "note": "Public read key: the source is public, so anyone may read the vault. A read key is derived one way and cannot write. The write key is never in this repository.",
            "created": "2026-11-17",
            "by": "data@PrompTugal.dinis"
           },
           "split": {
            "code": [
             "the collector reads the source and writes latest.json, reads.json and the vault copy",
             "GitHub Actions runs it every hour and deploys the site",
             "the build makes the API, the OpenAPI description and the pages"
            ],
            "agents": [
             "data@PrompTugal.dinis (Opus) wrote the collector, this card and the pages on 17 November 2026; data.dev@ and data.design@ (Sonnet) wrote parts of the site build and the design variations"
            ],
            "people": [
             "Dinis Cruz instructs; no person has checked the values yet (not reviewed)"
            ]
           },
           "cost": {
            "per_run_tokens": 0,
            "per_run_model_cost_usd": 0,
            "runner": "GitHub Actions on a public repository: no charge (GitHub's terms for public repositories); about 3 minutes a run for all sources together (measured locally, 17 November 2026)",
            "build_tokens": "not measured: accountant@'s ledger is not running on this account; to be added when it is",
            "note": "Code only: no model is called when the data is collected."
           },
           "since": "2026-11-17"
          }
         }
        }
       }
      }
     },
     "404": {
      "description": "No such file"
     }
    }
   }
  },
  "/api/v1/adsb-faro/openapi.json": {
   "get": {
    "operationId": "get_adsb_faro_openapi",
    "tags": [
     "adsb-faro"
    ],
    "summary": "Flights around Faro airport: this document",
    "responses": {
     "200": {
      "description": "The file",
      "content": {
       "application/json": {
        "schema": {
         "type": "string"
        }
       }
      }
     }
    }
   }
  }
 },
 "tags": [
  {
   "name": "adsb-faro",
   "description": "Aircraft seen within 40 nautical miles of Faro airport: airline flights by callsign, airline and type; every other aircraft only counted."
  }
 ],
 "x-source": {
  "id": "adsb-faro",
  "card": "https://data.promptugal.news/api/v1/adsb-faro/card.json",
  "page": "https://data.promptugal.news/sources/adsb-faro/"
 }
}
