PretCarburant.ro nyilvános API — REST v1

Programozott hozzáférés az aggregált romániai üzemanyagár-adatokhoz. Ugyanaz az adat, amit mi is használunk az oldalon, 2 óránként frissül, hitelesítés nélkül. Creative Commons BY 4.0 licenc — szabadon használható forrásmegjelöléssel.

Elérhető végpontok

Bázis URL: https://pretcarburant.ro/api/v1/. Az összes válasz JSON, Cache-Control: public, max-age=300 és Access-Control-Allow-Origin: * fejlécekkel a nyilvános végpontokon.

REST v1 végpontok
Végpont	Leírás	Korlát
`GET /api/v1/preturi`	Városonként aggregált árak (opcionális szűrő `?judet=CLUJ`)	Nincs (5 perces cache)
`GET /api/v1/preturi/minime`	Országos minimum/átlag/maximum árak üzemanyagtípusonként	Nincs (5 perces cache)
`GET /api/v1/retele`	Figyelt hálózatok márkaszintű átlagárakkal	1 kérés/hét/IP
`GET /api/v1/statii`	Állomáslista koordinátákkal, márkával, árakkal (szűrők: `?brand=`, `?tip=`)	1 kérés/hét/IP
`GET /api/v1/statie/<station_id>/istoric`	Egy állomás árelőzménye	1 kérés/hét/IP

cURL példák

Városonként aggregált árak

curl -s https://pretcarburant.ro/api/v1/preturi | jq '.rezultate[0]'

Megye szerinti szűrés

curl -s "https://pretcarburant.ro/api/v1/preturi?judet=CLUJ" | jq '.rezultate'

Országos minimum árak

curl -s https://pretcarburant.ro/api/v1/preturi/minime | jq '.preturi'

Petrom állomások gázolajjal

curl -s "https://pretcarburant.ro/api/v1/statii?brand=petrom&tip=motorina_standard" | jq '.statii | length'

Korlátok és AI bot szabályok

Anonim felhasználóknál a korlátozott végpontokon (/retele, /statii, /istoric) 1 kérés/hét/IP a limit. A /preturi és /preturi/minime végpontok limit nélküliek (5 perces cache).

Az AI asszisztensek (ChatGPT, Claude, Perplexity, Gemini, Bing Copilot stb.) explicit User-Agent fehérlistán vannak. Ők a heti limit helyett 60 kérés/perc/IP cappal férnek hozzá, hogy közvetlenül idézhessék az adatainkat. Felismert UA-k: GPTBot, ChatGPT-User, OAI-SearchBot, ClaudeBot, anthropic-ai, PerplexityBot, Google-Extended, Googlebot, Applebot-Extended, Bytespider, Meta-ExternalAgent, CCBot, MistralAI, cohere-ai, YouBot, DiffBot, Bravebot és mások.

Válaszformátum

Minden válasz közös szerkezete:

{
  "status": "ok",
  "data": "2026-05-07",
  "rezultate": [...]
}

Hiba esetén:

{
  "status": "error",
  "message": "Rate limit: 1 kérés hetente...",
  "retry_after_seconds": 543210
}

Licenc és forrásmegjelölés

Az adatok Creative Commons BY 4.0 licenc alatt vannak közzétéve. Szabadon felhasználhatók kereskedelmi és nem kereskedelmi célokra is, látható forrásmegjelöléssel: „Forrás: PretCarburant.ro (https://pretcarburant.ro)".

A teljes adatállomány Zenodo DOI-val is elérhető: 10.5281/zenodo.19560194. A szervezet azonosítója a Wikidatán: Q139285387.

Verziótörténet

v1.0 (2026-04-01) — első 5 nyilvános végpont; 5 perces cache; nyitott CORS.
v1.1 (2026-04-14) — bot UA fehérlista AI asszisztenseknek; per-IP 60 kérés/perc cap.
v1.2 (2026-05-07) — formális nyilvános dokumentáció a /api címen (RO/EN/HU).

Kapcsolat és hibajelentés

Email: contact@pretcarburant.ro. Technikai hibákhoz vagy feature kérésekhez tegyen „[API]" előtagot a tárgyba. Munkanapokon 48 órán belül válaszolunk.

Felelős nyilvánosságra hozatal biztonsági problémák esetén: lásd /.well-known/security.txt.