Ingyenes · kulcs nélkül · JSON
API
Ugyanazok az adatok, amiket az oldalon látsz, gépileg olvasható formában. Fejlesztőknek és AI-asszisztenseknek. Az adatok naponta többször frissülnek.
Végpontok
| Útvonal | Tartalom |
|---|---|
/api/v1/telepules/{slug}.json | Bármely település (kb. 850) eredménye; a kisebbeknél a legközelebbi város előrejelzésével. A slug a név kisbetűvel, ékezet nélkül, kötőjelekkel. |
/api/v1/varos/{slug}.json | Egy város mai pontszáma, fokozata, indoklása, és 14 napos napi előrejelzés napi pontszámmal. |
/api/v1/telepulesek.json | Kb. 850 település koordinátával; a varos mező mondja meg, melyik városoldal adata vonatkozik rá. |
/api/v1/osszesito.json | Minden város mai eredménye. |
/api/v1/szabalyok.json | Szabályok és ajánlások forrással és ellenőrzési dátummal. |
/openapi.json | OpenAPI 3.1 leírás. |
MCP-szerver AI-asszisztenseknek
Az adatok MCP-eszközként is elérhetők, így a Claude, a ChatGPT és más AI-agentek közvetlenül meg tudják hívni őket. Távoli MCP-szerver (Streamable HTTP), hitelesítés nélkül:
https://mcp.gumiido.hu/mcp
Eszközök: gumicsere_surgosseg (település és opcionális dátum), telepules_kereses, orszagos_osszesito, teligumi_szabalyok. Claude-ban: Beállítások → Connectors → egyéni connector hozzáadása ezzel a címmel.
Példa
curl https://gumiido.hu/api/v1/varos/debrecen.json
Mezők
ma.pont: 0–100, minél magasabb, annál sürgősebb a váltás. ma.uzemmod: tel (szeptember–február, téli gumira váltás) vagy nyar (március–augusztus, nyári gumira váltás). ma.fokozat: téli üzemmódban raer, tervezd, heten, most; nyáriban maradj, hamarosan, valthatsz, ideje. ma.tenyezok: a pontszám összetevői szövegesen.
Tetszőleges koordinátára
Töltsd le a telepulesek.json-t, keresd meg a legközelebbi települést, és kérd le a varos mezőben szereplő városoldalt.
Feltételek
Ingyenesen használható, kérjük, hivatkozz az oldalra (https://gumiido.hu). Az időjárás-adat forrása az Open-Meteo, a települések a GeoNames adatai (CC BY 4.0). Tájékoztató jellegű, nem jogi tanács.