Endpoint-uri REST gratuite pentru dezvoltatori și aplicații
Oferim acces gratuit la date despre orașul Onești prin API-uri REST simple. Toate răspunsurile sunt în format JSON și nu necesită autentificare.
Click pe fiecare endpoint pentru a vedea răspunsul în timp real
/api/data/weather
↗
Returnează condițiile meteo actuale pentru Onești: temperatură, umiditate, vânt, presiune atmosferică și descriere.
/api/data/air-quality
↗
Returnează indicele de calitate a aerului (AQI) și concentrațiile de poluanți: PM2.5, PM10, O₃, NO₂, CO, SO₂.
/api/data/forecast
↗
Returnează prognoza meteo pentru următoarele 5 zile cu temperaturi și condiții atmosferice.
/api/data/news
↗
Returnează știri agregate din surse locale: Curierul de Onești, Unul pe Trotuș și alte publicații regionale.
/api/messages
↗
Returnează mesajele aprobate trimise de comunitate. Suportă filtrare după status și limită.
/api/data/now-playing
↗
Returnează informații despre melodia curentă de la Radio Onești AI: titlu, artist, album art, ascultători.
/api/data/city-stats
↗
Returnează informații despre orașul Onești: populație, suprafață, coordonate, repere și date despre seturi de date disponibile.
/api/health
↗
Returnează starea sistemului și a serviciilor: OpenAI, email, bază de date, cache-uri active.
Structura tipică a unui răspuns JSON de la API
{
"success": true,
"cached": false,
"data": {
"city": "Onești",
"country": "RO",
"temperature": 22,
"feelsLike": 21,
"humidity": 65,
"pressure": 1015,
"description": "cer senin",
"icon": "01d",
"windSpeed": 2.5,
"windDirection": 180,
"clouds": 10,
"visibility": 10000,
"sunrise": 1699168800,
"sunset": 1699205400,
"timestamp": "2025-01-08T10:30:00.000Z"
}
}API-urile sunt limitate la 100 de cereri pe 15 minute per IP. Depășirea limitei va returna status 429.
Răspunsurile sunt cache-uite server-side. Câmpul "cached" indică dacă datele provin din cache.
API-urile suportă CORS pentru toate originile, permițând integrarea în aplicații web și mobile.
Erorile returnează câmpul "success: false" împreună cu un mesaj descriptiv în câmpul "error".