Nyilvános API-végpontok

A Haszno által hitelesítési adatok nélkül kiszolgált összes végpont teljes referenciája.

Összefoglalás

Az alábbi táblázatban szereplő összes végpont hívható a https://haszno.com alap URL-en Authorization fejléc vagy egyéb hitelesítési adat nélkül. A hitelesítési adatokat igénylő végpontokhoz lásd a Védett végpontok oldalt.

Rendszer

GET/api/health

Életjelzési mutatót ad vissza. Ezzel ellenőrizheted, hogy az API elérhető-e, mielőtt más kéréseket küldesz.

Nyilvános Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body https://haszno.com/api/health

Válasz (200)

{"ok":true}

GET/api/geo

Visszaadja a látogató országkódját és a javasolt felhasználói felület nyelvét. Az ország az élhálózat által beállított kérésfejlécekből kerül meghatározásra (x-vercel-ip-country vagy cf-ipcountry). Az API-szerver soha nem tárolja és nem naplózza az IP-címeket.

Nyilvános Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body https://haszno.com/api/geo

Válasz (200)

{"country":"HU","lang":"hu"}

Demó-katalógusadatok

Az alábbi végpontok szintetikus mintaadatot adnak vissza. A választörzsben szerepel "demo": true, ahol értelmezhető. A partnerCount a demóban mindig 0 — valódi beszállítók nincsenek csatlakoztatva.

GET/api/categories

Visszaadja a termékek rendszerezéséhez használt teljes kategória-taxonómiát. Minden bejegyzés tartalmazza a demó adathalmazra vonatkozó darabszámokat.

Nyilvános Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body https://haszno.com/api/categories

Válasz (200)

Kategória-objektumok tömbjét adja vissza. Mindig mind a 14 kategóriát visszaadja; szűrés és lapozás nincs.

[
  {
    "key": "auto",
    "label": "Autó, gumi és motor",
    "emoji": "🛞",
    "partnerCount": 0,
    "exampleCount": 1,
    "productCount": 100
  },
  {
    "key": "kert",
    "label": "Kert és növény",
    "emoji": "🌿",
    "partnerCount": 0,
    "exampleCount": 1,
    "productCount": 100
  }
]

Megjegyzések

• partnerCount: 0 a demóban várt érték — nincsenek valódi csatlakoztatott beszállítók.
• A key értéket add meg a cats paraméterben, ha termékeket vagy statisztikákat szűrsz.

GET/api/products

Visszaadja a termékkatalógust bruttó árakkal, nettó bekerülési árakkal, piaci árak összehasonlításával és árazási javaslatokkal. Ez az integrációs munka fő olvasási végpontja.

Nyilvános Csak olvasás

Paraméterek

Kérés

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

Válasz (200)

Tömböt ad vissza. Minden elem egy terméket képvisel.

A recommended almezői

A recommended.status enum értékei

Piaci ajánlat objektum (minden slot a marketByCountry-ban és minden elem a markets-ben)

A demó mindkét helyen ezt a teljes objektumot adja vissza. Valódi példányon a marketByCountry slotjaiban nincs market és isCheapest mező, a markets elemeiben pedig nincs fetchedAt.

{
  "id": 101,
  "category": "kert",
  "supplierId": 2,
  "sku": "DEMO-101",
  "name": "Kerti napernyő · 1. változat",
  "supplierName": "Példa-partner · Kert és növény",
  "costNet": 1121,
  "priceGross": 2190,
  "rrpGross": 2190,
  "marketMinGross": 2124,
  "marketShop": "Példa-bolt · HU",
  "stock": 0,
  "listed": true,
  "current": {"marginNet": 603, "marginPct": 35},
  "recommended": {
    "priceGross": 2090,
    "floorGross": 1590,
    "status": "versenykepes",
    "marginNet": 525,
    "marginPct": 31.9
  },
  "marketByCountry": {
    "hu": {
      "market": "hu",
      "country": "HU",
      "minGross": 2124,
      "shop": "Példa-bolt · HU",
      "url": null,
      "source": "mock",
      "fetchedAt": "2026-11-10T00:00:00.000Z",
      "isCheapest": true
    },
    "sk": {
      "market": "sk",
      "country": "SK",
      "minGross": 2650,
      "shop": "Példa-bolt · SK",
      "url": null,
      "source": "mock",
      "fetchedAt": "2026-11-10T00:00:00.000Z",
      "isCheapest": false
    },
    "eu": null
  },
  "bestMarket": null,
  "markets": [
    {"market":"hu","country":"HU","minGross":2124,"shop":"Példa-bolt · HU",
     "url":null,"source":"mock","fetchedAt":"2026-11-10T00:00:00.000Z","isCheapest":true},
    {"market":"sk","country":"SK","minGross":2650,"shop":"Példa-bolt · SK",
     "url":null,"source":"mock","fetchedAt":"2026-11-10T00:00:00.000Z","isCheapest":false}
  ]
}

Megjegyzések

• Az árak null értéke ismeretlen vagy nem elérhető adatot jelent, nem nullát.
• source: "mock" a piaci árakon azt jelenti, hogy az ár nem ellenőrzött, élő piaci eredmény.
• A nyilvános demóban a current.marginPct rögzített helyőrző érték (35), amely nem az árakból következik, a current.marginNet viszont számított érték: round(priceGross / 1.27 − costNet), mindig 27 %-os áfával. Csak a recommended követi az undercutPct, minMarginPct és vatPct paramétert.
• Egyetlen tömbben adja vissza az összes egyező terméket. Ezen a végponton nincs lapozás.

GET/api/products/supplier-counts

Visszaadja a termékek számát beszállítónként. Hasznos a teljes katalógus betöltése nélküli beszállítói bontás megjelenítéséhez.

Nyilvános Csak olvasás

Paraméterek

A demóban ugyanazok a szűrőparaméterek, mint a GET /api/products esetén: cats, supplier. Valódi példány ezeket figyelmen kívül hagyja, és minden beszállító listázott termékeit megszámolja.

Kérés

curl --fail-with-body 'https://haszno.com/api/products/supplier-counts?cats=kert'

Válasz (200)

Tömböt ad vissza. Csak azok a beszállítók szerepelnek, amelyeknek legalább egy egyező termékük van.

[
  {"id": 2, "name": "Példa-partner · Kert és növény", "count": 100}
]

GET/api/suppliers

Visszaadja a boltban konfigurált beszállítók listáját. A demóban szintetikus minta-beszállítókat ad vissza.

Nyilvános Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body https://haszno.com/api/suppliers

Válasz (200)

Beszállítóobjektumok tömbjét adja vissza.

[
  {
    "id": 1,
    "name": "Példa-partner · Autó, gumi és motor",
    "category": "auto",
    "visibility": "private",
    "network": false,
    "orderMode": "email",
    "email": null
  }
]

GET/api/stats

Visszaadja az irányítópult összefoglaló-számait. Ezeket az opcionális szűrőknek megfelelő összes terméken számítja ki.

Nyilvános Csak olvasás

Paraméterek

Kérés

curl --fail-with-body https://haszno.com/api/stats

Válasz (200)

{"products":1400,"losing":0,"overMarket":1400,"toFix":1400,"orders":0}

Megjegyzések

• orders: 0 a demóban várt érték — valódi rendelések nem léteznek.
• overMarket: 1400 a demóban azt tükrözi, hogy mind az 1 400 szintetikus termék a (szintetikus) piaci minimumuk felett van árazva.

GET/api/settings

Visszaadja a bolt aktuális árazási szabálykonfigurációját.

Nyilvános Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body https://haszno.com/api/settings

Válasz (200)

{
  "undercutPct": 1,
  "minMarginPct": 10,
  "vatPct": 27,
  "shippingMarkets": ["HU"],
  "automationPaused": true,
  "demo": true
}

GET/api/impact

Visszaadja a Haszno átárazási és új termékfelvételi motorjának tulajdonított extra nyereséget egy beállítható időablakra vetítve.

Nyilvános Csak olvasás

Paraméterek

Kérés

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

Válasz (200)

Az items almezői

{
  "days": 30,
  "from": "2026-10-13T14:08:40.424Z",
  "to": "2026-11-12T14:08:40.424Z",
  "orders": 80,
  "revenueGross": 383700,
  "profitNet": 92996,
  "arfutarImpact": 110647,
  "fromRepricing": 66658,
  "fromNewProducts": 43989,
  "lossProductsFixed": 2,
  "autoForwardedOrders": 64,
  "minutesPerOrder": 6,
  "items": [
    {
      "productId": 3,
      "name": "Ablaktörlő · 1. változat",
      "kind": "felvetel",
      "oldPriceGross": null,
      "newPriceGross": 3990,
      "unitsBeforePerDay": 0,
      "unitsAfter": 40,
      "actualProfit": 43989,
      "expectedProfit": 0,
      "impact": 43989,
      "insufficientHistory": false
    }
  ],
  "demo": true
}

GET/api/orders

Visszaadja az utolsó 50 rendelést, legújabbtól a legrégebbiig. A nyilvános demó üres tömböt ad vissza.

Nyilvános Csak olvasás

Paraméterek

A demóban nincsenek. Valódi példány elfogadja a cats paramétert (vesszővel elválasztott kategóriakulcsok): ekkor csak azokat a rendeléseket adja vissza, amelyekben van legalább egy tétel ezekből a kategóriákból.

Kérés

curl --fail-with-body https://haszno.com/api/orders

Válasz (200)

Rendelésobjektumok tömbjét adja vissza (a demóban üres), a legújabbal kezdve. Minden valódi rendelés tartalmazza: id, externalId, customerName, customerEmail, address, status, supplierOrderId, trackingNumber, totalGross (HUF), events (tömb: {at, text}), createdAt, forwardingStartedAt, shopId és items (tömb: {orderId, qty, priceGross, name, sku}).

[]

GET/api/proposals

Visszaadja az árazási motor által generált árjavaslatokat. A nyilvános demó üres tömböt ad vissza.

Nyilvános Csak olvasás

Paraméterek

A demóban nincsenek. Valódi példány elfogadja a status (alapértelmezés: pending), a limit (alapértelmezés 50, legfeljebb 200) és a cats paramétert.

Kérés

curl --fail-with-body https://haszno.com/api/proposals

Válasz (200)

Árjavaslat-objektumok tömbjét adja vissza (a demóban üres). Minden elem: id, productId, productName, productSku, productImage, supplierName, oldPriceGross, proposedPriceGross, reason, source, status ("pending", "approved", "rejected", "rolled_back", "stale"), batchId, createdAt, decidedAt.

[]

GET/api/peers/invites

Visszaadja a bolt kimenő társ-meghívókódjait. A nyilvános demó üres tömböt ad vissza.

Nyilvános Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body https://haszno.com/api/peers/invites

Válasz (200)

Meghívóobjektumok tömbjét adja vissza (a demóban üres). Minden elem: id, code, createdBy, supplierId, supplierName, expiresAt, acceptedBy, acceptedAt, revokedAt, createdAt.

[]

GET/api/peers/links

Visszaadja a boltok közötti létrejött társ-összekapcsolásokat. A nyilvános demó üres tömböt ad vissza.

Nyilvános Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body https://haszno.com/api/peers/links

Válasz (200)

Összekapcsolás-objektumok tömbjét adja vissza (a demóban üres). Minden elem: id, supplierId, partner, createdAt, supplierName, supplierCategory.

[]

GET/api/import-list

Visszaadja az importlistát — a partnerkatalógusból kiválasztott, csatlakoztatott webshopba való feltöltés előtt álló termékeket.

Nyilvános Csak olvasás

Paraméterek

Kérés

curl --fail-with-body 'https://haszno.com/api/import-list?status=varakozik'

Válasz (200)

Importlista-tételek tömbjét adja vissza.

A networkProduct almezői

[
  {
    "id": 1,
    "addedAt": "2026-11-10T08:00:00.000Z",
    "status": "varakozik",
    "note": null,
    "pushedProductId": null,
    "networkProduct": {
      "id": 1,
      "name": "Autós telefontartó · 1. változat",
      "imageUrl": null,
      "sku": "DEMO-1",
      "wholesaleNet": 1019,
      "rrpGross": 1990,
      "stock": 0,
      "category": "Autó, gumi és motor",
      "supplierName": "Példa-partner · Autó, gumi és motor",
      "example": true,
      "marginNet": 548,
      "marginPct": 35
    }
  }
]

Blog és piaci elemzések

A blog-végpontok valódi adatot adnak vissza — összesített (anonimizált, legalább 5 boltból) trendadatokból generált, közzétett piaci elemzés bejegyzéseket. Ezekben a válaszokban nem szerepel "demo": true jelölő.

GET/api/blog

Visszaadja az összes közzétett piaci elemzés bejegyzést, legújabbtól a legrégebbiig.

Nyilvános Csak olvasás

Paraméterek

Kérés

curl --fail-with-body https://haszno.com/api/blog

Válasz (200)

Bejegyzés-elem mezői

{
  "posts": [
    {
      "id": 2,
      "slug": "2026-het45-toplista",
      "period": "het",
      "periodStart": "2026-11-02",
      "periodEnd": "2026-11-08",
      "title": "2026/45. hét — Legjobban fogyó termékek",
      "summary": "A 45. héten párásítók és LED-es világítástechnikai termékek forgalma emelkedett...",
      "publishedAt": "2026-11-09T08:00:00.000Z",
      "coverImageUrl": null
    }
  ],
  "total": 3,
  "page": 1,
  "perPage": 10
}

GET/api/blog/:slug

Visszaad egy közzétett bejegyzést a slug alapján.

Nyilvános Csak olvasás

Útvonalparaméterek

Kérés

curl --fail-with-body https://haszno.com/api/blog/2026-het45-toplista

Válasz (200)

Egyetlen bejegyzésobjektumot ad vissza. A listaelemekkel ellentétben nincs benne coverImageUrl.

Ha a slug után .md utótagot írsz (/api/blog/2026-het45-toplista.md), csak a bodyMd tartalmat kapod meg, text/markdown; charset=utf-8 típussal.

Hibaválaszok

GET/api/blog/rss.xml

Visszaadja a közzétett bejegyzések RSS 2.0 feedjét. A válasz tartalomtípusa application/rss+xml; charset=utf-8.

Nyilvános Csak olvasás

Kérés

curl --fail-with-body https://haszno.com/api/blog/rss.xml

GET/api/blog/feed.json

Visszaadja a közzétett bejegyzések JSON Feed (1.1-es verzió) feedjét. A válasz tartalomtípusa application/feed+json; charset=utf-8.

Nyilvános Csak olvasás

Kérés

curl --fail-with-body https://haszno.com/api/blog/feed.json

Segédvégpontok

GET/llms.txt

Visszaadja az llms.txt konvenciót követő, LLM által olvasható webhely-összefoglalót. Tartalomtípus: text/plain.

Nyilvános Csak olvasás

Kérés

curl --fail-with-body https://haszno.com/llms.txt