A boltod adatai.
Egy egyszerű API.

Termékek, árjavaslatok, haszon és rendelések — a Haszno jelenlegi HTTP-végpontjainak használati útmutatója.

A nyilvános demó csak szintetikus példaadatot ad. Nem valódi boltok rendeléseit, kulcsait vagy élő piaci árait mutatja. A felület fejlesztői előzetes; a szerződés még változhat.

Első kérés, kulcs nélkül

Kérd le a kert kategória példa-termékeit. A demó kategóriánként 100 terméket tartalmaz.

curl --fail-with-body \
  'https://haszno.com/api/products?cats=kert&shippingMarkets=HU,SK,DE'

Kategóriák és a Haszon-mérő lekérdezése:

curl --fail-with-body 'https://haszno.com/api/categories'
curl --fail-with-body 'https://haszno.com/api/impact?days=30&cats=kert'

JavaScript — szerveroldali példa:

const response = await fetch(
  'https://haszno.com/api/products?cats=kert'
)
if (!response.ok) throw new Error(`HTTP ${response.status}`)
const products = await response.json()
if (!Array.isArray(products)) throw new Error('Hibás terméklista')
console.log(products[0].name)

Hitelesítés és biztonság

A felsorolt nyilvános demó GET-kérésekhez ne adj Authorization fejlécet. A védett végpontok a jelenlegi demótelepítésben HTTP Basic hitelesítést használnak; a hozzáférést külön kell egyeztetni.

Védett lekérdezés kizárólag jogosult tesztkörnyezetben:

# A curl bekéri a külön kapott jelszót; ne írd forráskódba.
curl --fail-with-body --user demo \
  'https://haszno.com/api/shop-connections'

A módosító műveletek nem nyilvánosak. A hiányzó vagy érvénytelen hozzáférés 401 választ ad; a böngésző natív belépési ablaka nem része az API-folyamatnak. Titkokat ne küldj kliensoldali kódba vagy URL-paraméterbe.

Nyilvános demó végpontok

Az alábbi GET-végpontok a jelenlegi éles demón hitelesítés nélkül elérhetők, kizárólag példaadatokkal.

Szűrés és országok

Országkódok: HU, SK, DE, AT, CZ, PL, RO. A marketByCountry.eu az EU-országok legolcsóbb összesített ajánlata; a markets listában a demó országonként jelöli az ajánlatokat.

A demó undercutPct, minMarginPct és vatPct paraméterei a kérésben számolt árjavaslatot módosítják. Nem mentenek éles beállítást. A felületen mentett demóbeállítások csak az adott böngésző helyi tárolójába kerülnek.

A válaszok olvasása

A JSON mezőkben szereplő árak forintban értendők. A costNet nettó beszerzés, a priceGross bruttó eladási ár. A null hiányzó adatot jelent, nem nulla forintot.

{
  "id": 1,
  "sku": "DEMO-1",
  "name": "Autós telefontartó · 1. változat",
  "supplierName": "Példa-partner · Autó, gumi és motor",
  "priceGross": 1990,
  "costNet": 1019,
  "marketByCountry": {
    "hu": {
      "minGross": 1930,
      "shop": "Példa-bolt · HU",
      "url": null,
      "country": "HU",
      "source": "mock",
      "fetchedAt": "2026-11-10T00:00:00.000Z"
    },
    "sk": null,
    "eu": null
  }
}

Védett integrációs felületek

A kódban meglévő fő belépési pontok. Ezek nem nyilvános demóvégpontok és nem jelentenek igazolt, éles szolgáltatói bekötést.

Számlázás, futárcímke, rendelésmódosítás, árfrissítés és piactéri publikálás mellékhatással járhat. Ezeket csak egyeztetett tesztkörnyezetben, jogosultság-ellenőrzéssel és jóváhagyással szabad használni.

Hibakezelés

Először mindig a HTTP-státuszt ellenőrizd, és csak sikeres válasz után kezeld a JSON-t termék- vagy rendeléslistaként.

HTTP 401
{
  "error": "A demóadatok megtekintéséhez hitelesítés szükséges."
}

• 400: hibás bemenet a védett API validált végpontjain.
• 401: hiányzó vagy érvénytelen hitelesítés.
• 404: ismeretlen erőforrás vagy útvonal.
• 5xx: szerverhiba; olvasást korlátozottan próbálj újra, módosítást ne ismételj vakon.

Nincs publikált SLA vagy általános API-sebességkorlát. Kerüld a tömeges párhuzamos lekéréseket; háttérfrissítéshez használj saját gyorsítótárat.