Üzemanyagár API Románia
Integráld a benzin, a gázolaj és az LPG árait az alkalmazásodba egyetlen JSON API-n keresztül: rendszeresen gyűjtött adatok a hivatalos ármonitorból és közvetlen forrásokból, az árak korára vonatkozó információkkal, 90 napos előzményekkel és termékkész végpontokkal az adott körzetben lévő állomásokhoz, az útvonal menti állomásokhoz és a megyei aggregátumokhoz. Minden csomag 3 napos ingyenes próbával indul, és bármikor lemondhatod az ügyfélportálon.
- Minden
/api/v1/*végpont - Élő árak állomásokra, városokra, megyékre, hálózatokra
- Árelőzmények akár 90 napra visszamenőleg
- 3 napos próba — bármikor lemondhatod
- Minden
/api/v1/*végpont - Élő árak állomásokra, városokra, megyékre, hálózatokra
- Árelőzmények akár 90 napra visszamenőleg
- 3 napos próba — bármikor lemondhatod
- Minden
/api/v1/*végpont - Élő árak állomásokra, városokra, megyékre, hálózatokra
- Árelőzmények akár 90 napra visszamenőleg
- 3 napos próba — bármikor lemondhatod
- Elsőbbségi e-mail támogatás
Az előfizetéssel elfogadod az Általános Szerződési Feltételeket. Az API-hozzáférés azonnal indul, és amint használod a kulcsot, a már teljesített időszakra elveszíted a 14 napos elállási jogot — részletek.
Meglévő ügyfél? A vezérlőpultod — élő fogyasztás, grafikon, kulcs — ott találod a számlákat, a csomagváltást és a lemondást is (az „Előfizetés & számlák" gomb). A próbaidőszak alatt nem terhelünk semmit; ha az első 3 napon belül lemondod, egyáltalán nem fizetsz.
Quickstart
curl -H "X-Api-Key: pcro_live_..." \
https://pretcarburant.ro/api/v1/preturi
{
"status": "ok",
"data": "2026-11-01",
"total": 366,
"preturi_lipsa": "null",
"rezultate": [ { "oras": "Cluj-Napoca", "judet": "CJ",
"benzina": 10.01, "motorina": 10.86, "gpl": 4.71, ... } ],
"retele": [ { "nume": "Petrom", "benzina": 10.01, "motorina": 10.86,
"gpl": null, ... } ]
}
Hitelesítés az X-Api-Key fejléccel. Minden válasz tartalmazza az X-RateLimit-Limit és X-RateLimit-Remaining fejléceket.
A nálunk hiányzó ár null értékkel érkezik, nem 0-val — különben az átlagait olyan értékek húznák le, amelyek a kútnál nem léteznek. Ha a régi, 0-s formátumra van szüksége, adja hozzá a ?zeros=1 paramétert; a preturi_lipsa mező minden válaszban közli, melyik konvenció volt érvényben. Részletek a dokumentációban.
Miért a mi API-nk
- Adatellenőrzés — árak a hivatalos ANPC ármonitorból és közvetlen forrásokból, kiugróérték-szűréssel és a bizonytalan rekordok megjelölésével.
- Átlátható frissesség — minden ár mellett szerepel az elérhető dátum és az ellenőrzés állapota; az adatok kor szerint szűrhetők.
- Termékkész végpontok — állomások adott körzetben, állomások egy útvonal mentén, megyei aggregátumok.
- Számlázási gondok nélkül — Stripe-előfizetés, automatikus havi számla, bármikor lemondhatod.
Tartalmazott végpontok
| Végpont | Leírás |
|---|---|
GET /api/v1/preturi | Legalacsonyabb ár városonként + hálózati átlagárak |
GET /api/v1/judete/<megye> | Megyei szintű aggregátum |
GET /api/v1/retele | Átlagárak hálózatonként |
GET /api/v1/statii | Töltőállomások koordinátákkal és árakkal (szűrők: márka, típus, lat/lon + sugár) |
GET /api/v1/statie/<id>/istoric | Állomásonkénti előzmények (max 90 nap) |
GET /api/v1/geocode | Városnevek automatikus kiegészítése |
POST /api/v1/traseu/custom | Töltőállomások egy A→B útvonal mentén |
GYIK
Milyen gyakran frissülnek az árak?
Naponta többször gyűjtünk adatokat. A hálózatok régebbi jelentéseket is küldhetnek. A gyűjtés időpontja nem garantál frissen mért árat: ellenőrizd minden rekord dátumát és állapotát.
Van próbaidőszak?
Igen — 3 nap ingyen bármelyik csomagnál. Bármikor lemondható az ügyfélportálon.
Mi történik, ha túllépem a havi limitet?
HTTP 429 választ kapsz frissítési linkkel; a limit a naptári hónap első napján nullázódik.
Hogyan kapom meg a számlát?
A Stripe automatikusan e-mailben küldi a havi számlát; minden az ügyfélportálon intézhető.
- Az adatok felhasználhatók az alkalmazásaidban és elemzéseidben, „PretCarburant.ro” forrásmegjelöléssel.
- A licenc megegyezik az API-dokumentációban szereplővel: Creative Commons BY 4.0, minden válaszra, kulccsal vagy anélkül. Az előfizetés a hozzáférést fizeti (teljes adatkészlet, havi kvóta, heti korlát nélkül), nem egy külön licencet.
- Az előfizetés havonta megújul; bármikor lemondható, a kulcs a kifizetett időszak végéig aktív marad.