Változásnapló és verziószámozás

A Haszno API verziószámozási szabályzata és a nyilvános fejlesztői előzetes dátumozott változásainak listája.

Verziószámozási szabályzat

A Haszno API verziószámozás nélküli fejlesztői előzetes. Az útvonalakban ma nincs verzióelőtag (nincs /v1/ vagy hasonló szegmens).

Stabil verzió bevezetésekor

Az alábbi szerződés akkor lép érvénybe, ha az API az általános elérhetőség szintjére emelkedik. Ma még nem érvényes.

• Bevezetünk egy stabil verzióelőtagot (/v1/).
• Végpont vagy válaszmező eltávolítása előtt 6 hónapos leállítási ablakot biztosítunk.
• A törésváltásokat ebben a változásnaplóban és e-mailben is bejelentjük a regisztrált fejlesztőknek.

Mi számít törésváltásnak

Ha már létezik stabil verzió, a következők törésváltásnak minősülnek:

• Végpont vagy HTTP-metódus eltávolítása.
• Korábban mindig jelenlévő válaszmező eltávolítása.
• Válaszmező típusának megváltoztatása (pl. sztringből egész szám).
• Kötelező kérésiparaméter típusának megváltoztatása vagy érvényes tartományának szűkítése.
• HTTP-státuszkód jelentésének megváltoztatása egy adott végponton.

A következők nem törésváltások, és előzetes értesítés nélkül megtörténhetnek:

• Új opcionális válaszmezők hozzáadása.
• Új opcionális kérésiparaméterek hozzáadása.
• Új végpontok hozzáadása.
• Validáció lazítása (korábban 400-at okozó értékek elfogadása).

Változásnapló

Az alábbi változások a tároló commit-előzményéből származnak (a docs és web/public/docs útvonalak csak olvasható git log-ja). Az API aktív fejlesztés alatt áll; ez a lista nem teljes körű.

2026-11-12

• docs redesign (#86) — a docs.haszno.com olvasásorientált háromoszlopos elrendezéssel, teljes szöveges keresőpárbeszédablakkal és frissített navigációs szerkezettel újraépítve.
• support hub (#81) — a support.haszno.com és az API-n belüli támogatási chat (POST /api/support/conversations) elindult.
• security hardening (#39) — útvonalankénti sebességkorlátok, biztonsági fejlécek (HSTS, CSP, X-Frame-Options), Vercel Cron-védelem, CI-folyamat, jogi oldalak és SEO-metaadatok alkalmazva.

2026-11-10

• English documentation (#49) — az összes dokumentációs oldal teljes angol fordítása, HU/EN nyelvváltóval és IP-alapú alapértelmezett nyelvválasztással.
• Public demo API — a szintetikus adatokat kiszolgáló, csak olvasható nyilvános GET-végpontok aktívak a https://haszno.com címen. Végpontok: /api/categories, /api/products, /api/suppliers, /api/stats, /api/settings, /api/impact, /api/orders, /api/proposals, /api/peers/invites, /api/peers/links, /api/import-list.
• MCP / CLI / skill — a haszno-mcp, haszno-cli és haszno-skill telepítője és egészségügyi ellenőrzése (haszno_ping, GET /api/health) közzétéve.

2026-11-08

• Rename Árfutár → Haszno (#15) — a termék és a domain átnevezve. Az ARFUTAR_API_KEY és az ARFUTAR_API_URL néma visszamenőleges kompatibilitási alternatívaként megmarad a CLI és az MCP-szerver konfigurációfeloldásában.
• Agent SDK (#10) — MCP-szerver (haszno-labs/haszno-mcp), CLI (haszno-labs/haszno-cli) és skill (haszno-labs/haszno-skill) első közzététele.
• Wave 2 features (#8) — rendeléstovábbítás, csoportos vásárlás, partnerpont-számítás, hálózati betekintések, bekötések, teljesítés, számlázás, indítóprogram, bevezetési folyamat és backend biztonsági megerősítés hozzáadva.