{"openapi":"3.1.0","info":{"title":"csillag.blackit.hu","description":"Csillagászati megfigyelés-támogató adatszolgáltatás magyar megfigyelőhelyekre. Óránként frissülő időjárás, efemerisz és megfigyelési alkalmassági pontszám.","version":"1.0"},"paths":{"/health":{"get":{"tags":["rendszer"],"summary":"Health","description":"Életjel — az Uptime Kuma ezt figyeli.","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Health Health Get"}}}}}}},"/api/locations":{"get":{"tags":["adat"],"summary":"Api Locations","description":"A választható megfigyelőhelyek, fényszennyezettségi adatokkal.\n\nAz `sky_quality_sqm` a Falchi et al. 2016 atlaszból származó, modellezett\nzenit-égfényesség mag/arcsec²-ben. A `bortle_approx` ebből számolt\nKÖZELÍTÉS — lásd a `bortle_note` mezőt.","operationId":"api_locations_api_locations_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Api Locations Api Locations Get"}}}}}}},"/api/night":{"get":{"tags":["adat"],"summary":"Api Night","description":"Egy éjszaka teljes képe — a fő végpont.\n\nEgyetlen hívásból megvan minden: napnyugta/napkelte, holdkelte/holdnyugta,\nholdfázis (százalék + növő/fogyó), a csillagászati sötétség ablaka,\nóránkénti felhőzet három modellből, megfigyelési pontszám óránként és az\néjszakára összesítve, a legjobb időablak, és a javasolt célpontok.\n\n**Az éjszaka definíciója:** a `date` az ESTE dátuma. A 2026-08-26-os\néjszaka 26-a estétől 27-e reggelig tart.\n\nA `score.penalties` tömb mutatja, mi rontja el az éjszakát (felhőzet,\nholdfény, fényszennyezés stb.) — ebből megfogalmazható, hogy miért nem\nérdemes kimenni, nem csak az, hogy nem érdemes.","operationId":"api_night_api_night_get","parameters":[{"name":"location","in":"query","required":false,"schema":{"type":"string","description":"Helyszín azonosítója (slug)","title":"Location"},"description":"Helyszín azonosítója (slug)"},{"name":"date","in":"query","required":false,"schema":{"type":"string","description":"Az éjszaka ESTÉJÉNEK dátuma (YYYY-MM-DD)","title":"Date"},"description":"Az éjszaka ESTÉJÉNEK dátuma (YYYY-MM-DD)"}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Api Night Api Night Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/forecast":{"get":{"tags":["adat"],"summary":"Api Forecast","description":"Éjszakánkénti összefoglaló a következő napokra — „mikor menjek ki?\"\n\nA `confidence` mezőt a felhasznált modell adja: az első három napra a\nnagy felbontású ALADIN (magas), utána durvább modellek (közepes/alacsony).","operationId":"api_forecast_api_forecast_get","parameters":[{"name":"location","in":"query","required":false,"schema":{"type":"string","title":"Location"}},{"name":"nights","in":"query","required":false,"schema":{"type":"integer","maximum":14,"minimum":1,"default":7,"title":"Nights"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Api Forecast Api Forecast Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/targets":{"get":{"tags":["adat"],"summary":"Api Targets","description":"Mélyég-célpontok az adott éjszakára.\n\nA rangsor a legnagyobb elért magasságot veszi alapul, és figyelembe veszi\na Hold zavaró hatását: fényes Hold mellett a keskenysávú (emissziós köd)\ncélpontok előre kerülnek, a szélessávúak (galaxis, halmaz) hátra.","operationId":"api_targets_api_targets_get","parameters":[{"name":"location","in":"query","required":false,"schema":{"type":"string","title":"Location"}},{"name":"date","in":"query","required":false,"schema":{"type":"string","title":"Date"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Api Targets Api Targets Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/status":{"get":{"tags":["rendszer"],"summary":"Api Status","description":"Az adatfrissítés állapota — mikor futott, sikerült-e, elavult-e.","operationId":"api_status_api_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Api Status Api Status Get"}}}}}}},"/api/schema":{"get":{"tags":["rendszer"],"summary":"Api Schema","description":"Mezőszótár: minden kulcs jelentése, mértékegysége és értéktartománya.\n\nAz API mezőnevei angolok és egység-utótagot viselnek (`_pct`, `_deg`,\n`_c`, `_kmh`, `_m`, `_mag`, `_hours`), a leírások itt magyarul vannak.","operationId":"api_schema_api_schema_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"additionalProperties":true,"type":"object","title":"Response Api Schema Api Schema Get"}}}}}}},"/api/refresh":{"post":{"tags":["rendszer"],"summary":"Api Refresh","description":"Kézi adatfrissítés. Tokenhez kötött, mert külső API-kvótát fogyaszt.","operationId":"api_refresh_api_refresh_post","parameters":[{"name":"authorization","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Authorization"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true,"title":"Response Api Refresh Api Refresh Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}