Açık veri · API referansı

Yıllık açık veri paketleri (CC BY 4.0): sürümler, dosyalar, boyut ve SHA-256; aynı paket Atlas'ta anahtarsız indirilir.

GET `/v1/open-data`

Published yearly open data packages (CC BY 4.0)

Kimlik: X-Api-Key başlığı; gereken kapsam: kapsam tablosu.

Durum	Açıklama	İçerik
`200`	Releases; `Cache-Control: private, max-age=300`	`application/json` → `OpenDataList`
`401`	code: `auth_missing`, `auth_invalid`, `auth_revoked`	`application/json` → `ErrorBody`
`403`	code: `auth_scope`	`application/json` → `ErrorBody`
`429`	code: `rate_limited`, `quota_exceeded` (`Retry-After` seconds) Başlıklar: `Retry-After` — Seconds until the exhausted window resets	`application/json` → `ErrorBody`

Download one file of a yearly open data package

Kimlik: X-Api-Key başlığı; gereken kapsam: kapsam tablosu.

Ad	Yer	Tip	Açıklama
`year` zorunlu	yol	`integer`	Release year `2026 ≤ x ≤ 9999`
`file` zorunlu	yol	`string`	A file the manifest lists `^(?:(?:thermals_r7\|thermals_r9\|sites\|hazards\|skyways)\.(?:parquet\|geojson)\|README\.md\|LICENSE\.txt\|manifest\.json)$`

Durum	Açıklama	İçerik
`200`	The file (folder stores)	`application/octet-stream` → `string` (binary)
`307`	Presigned object store URL, valid 10 minutes (S3 stores)
`401`	code: `auth_missing`, `auth_invalid`, `auth_revoked`	`application/json` → `ErrorBody`
`403`	code: `auth_scope`	`application/json` → `ErrorBody`
`404`	code: `open_data_not_found`	`application/json` → `ErrorBody`
`422`	code: `request_invalid`	`application/json` → `ErrorBody`
`429`	code: `rate_limited`, `quota_exceeded` (`Retry-After` seconds) Başlıklar: `Retry-After` — Seconds until the exhausted window resets	`application/json` → `ErrorBody`