DOCS / UWA V1 RELEASE CONTRACT SELF-HOSTED GATEWAY
GET /v1/air-quality
CAMS model air-quality forecasts (air_quality.v1 · experimental)
On this page 4 sections
#Request
Required scope: air-quality:read. Registered in internal/routing/router.go (requires APP_RELEASE_PROFILE=full_experimental in dev/test).
#Parameters
| Parameter | Type | Notes |
|---|---|---|
lat, lon | number | Coordinates are required |
hours | integer | 1–120 forecast points (default 24) |
provider | string | Optional override |
#Request example
curl -H "X-API-Key: YOUR_GATEWAY_KEY" "http://127.0.0.1:8080/v1/air-quality?lat=21.21&lon=81.43"Verified against the UWA v1 router and request parsers. Replace YOUR_GATEWAY_KEY and configure an eligible upstream provider.
#Availability and provenance
Operator configuration required
Experimental route (requires APP_RELEASE_PROFILE=full_experimental in dev/test and noncommercial Open-Meteo opt-in).
Successful responses return canonical data plus meta (provider attribution, cache/fallback state, request correlation, and meta.partial on /v1/datasets). Refer to docs/openapi.yaml and docs/openapi.experimental.yaml for complete schema definitions.
Canonical contracts:
docs/openapi.yaml (lean_v1) and docs/openapi.experimental.yaml · Verify against your build before production use.