Védett végpontok

Hitelesítési adatokat igénylő API-végpontok — a fiókvégpontokhoz munkamenet-cookie, a haszno.com minden más végpontjához a Haszno csapatával egyeztetett HTTP Basic jelszó kell.

Áttekintés

A https://haszno.com hosztolt demóján a végpontcsoportok végpontjaihoz HTTP Basic hitelesítési fejléc (demo:<jelszó>) kell. Kivételt a fiók- és munkamenet-végpontok jelentenek: ezek nincsenek a Basic fal mögött, helyette munkamenet-cookie-t használnak. Ha saját telepítésen be van állítva a HASZNO_API_KEY, a Basic hitelesítés helyett ezt a kulcsot küldd az x-api-key fejlécben; ha nincs beállítva, az útvonalak nyitottak.

A Basic jelszót a Haszno csapatától szerezheted be. Az ezen az oldalon szereplő példák a $HASZNO_BASIC helyőrzőt használják (Basic auth hitelesítési adatok felhasználó:jelszó formátumban), amelyet a saját környezetedből olvas be a rendszer. Soha ne égess bele hitelesítési adatokat a kódba.

# Egyszeri beállítás a shellben:
export HASZNO_BASIC="demo:your-password-here"

Fiók- és munkamenet-végpontok

Ezekhez a végpontokhoz nem kell a HTTP Basic jelszó, még a haszno.com-on sem. Munkamenet-cookie-val (haszno_session, 30 napig érvényes) működnek, amelyet a register és a login állít be.

• A munkamenet-cookie csak ezeket a végpontokat nyitja meg. A haszno.com-on a végpontcsoportok útvonalaihoz nem ad hozzáférést.
• A tokenvégpontok csak munkamenet-cookie-t fogadnak el, így Bearer-tokennel nem hozhatsz létre, nem listázhatsz és nem vonhatsz vissza tokent.
• Munkamenet-cookie-val a /api/auth/tokens POST és DELETE kérésének az oldal saját eredetéről kell érkeznie (CSRF-ellenőrzés, különben 403). A register, a login és a logout kivétel.
• Ha saját telepítésen be van állítva a HASZNO_API_KEY, a register, a login, a logout és a me kihagyja a kulcsellenőrzést, a /api/auth/tokens végpontokhoz viszont x-api-key is kell.
• A register és a login sebességkorlátait a Hibák oldal sorolja fel.

Végpontcsoportok

A haszno.com-on az alábbi csoportok minden végpontjához kell a HTTP Basic jelszó.

Bolt beállításai

Termékek — saját bolt

Beszállítói hálózat és katalógus

Javaslatok és ötletek

Rendelések

Feedek

Szabályok és automatizálás

Árjavaslatok

Társkapcsolatok és megosztás

Bolt-összekapcsolások és piactér

Útválasztás

Teljesítés

Betekintések és riportok

Partnerek és metrikák

Számlázás

Csoportos vásárlások

Bolt-connect API, keresés és elemzés

Boltindítás és onboarding

Teljes referencia — 10 legfontosabb végpont

GET/api/recommendations

Visszaad egy rövidlistát a partnerkatalógus termékeiből, trendlendület, haszonpotenciál és piaci elérhetőség szerint rangsorolva. Ezzel derítheted fel, mely termékek érdemes felvenni a boltba.

Védett Csak olvasás

Paraméterek

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  'https://haszno.com/api/recommendations?cats=kert'

Válasz (200)

Az items almezői (kiválasztott)

{
  "anchor": "kerti napernyő",
  "geo": "HU",
  "items": [
    {
      "id": 212,
      "name": "Kerti napernyő · Prémium",
      "sku": "DEMO-212",
      "supplierName": "Példa-partner · Kert és növény",
      "wholesaleNet": 3200,
      "rrpGross": 7990,
      "stock": 15,
      "marginNet": 2080,
      "marginPct": 32.8,
      "recommendedPriceGross": 7490,
      "keyword": "kerti napernyő",
      "interest4w": 72,
      "interest12m": 61,
      "trend": "up",
      "momentum": 1.18,
      "score100": 84
    }
  ]
}

GET/api/catalogue/products

Keresi a megosztott partnertermék-katalógust. Támogat szabad szöveges keresést, kategória- és beszállítószűrőt, haszon- és ársávokat, valamint lapozást. Ez az új termékek bolthoz adásának fő felderítési végpontja.

Védett Csak olvasás

Paraméterek

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  'https://haszno.com/api/catalogue/products?q=napernyő&inStock=1&sort=margin_desc&pageSize=10'

Válasz (200)

Az items minden eleme: id, name, sku, supplierName, supplierId, category, wholesaleNet (HUF), rrpGross (HUF), stock, imageUrl, country, marginNet (HUF), marginPct.

{
  "items": [
    {
      "id": 212,
      "name": "Kerti napernyő · Prémium",
      "sku": "SUP-212",
      "supplierName": "Minta Kft.",
      "supplierId": 7,
      "category": "kert",
      "wholesaleNet": 3200,
      "rrpGross": 7990,
      "stock": 15,
      "imageUrl": null,
      "country": "HU",
      "marginNet": 2080,
      "marginPct": 32.8
    }
  ],
  "total": 142,
  "facets": {
    "categories": [{"key": "kert", "count": 142}],
    "suppliers": [{"id": 7, "name": "Minta Kft.", "count": 142}]
  }
}

POST/api/feeds/import

Importál egy beszállítói termékfeedet. Legfeljebb 10 MB méretű CSV vagy XML formátumot fogad el. Új termékeket hoz létre, és SKU alapján frissíti a meglévőket.

Védett Írás

Kéréstörzs (Content-Type: application/json)

CSV-formátum: egy fejlécsor, majd adatsorok. Kötelező oszlopok: sku, name, costNet, stock. Opcionális: rrpGross.

sku,name,costNet,stock,rrpGross
ABC-001,Kerti szék,2100,10,4990
ABC-002,Kerti asztal,8500,3,19990

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  -X POST https://haszno.com/api/feeds/import \
  -H 'Content-Type: application/json' \
  -d '{
    "supplierId": 3,
    "format": "csv",
    "content": "sku,name,costNet,stock,rrpGross\nABC-001,Kerti szék,2100,10,4990"
  }'

Válasz (200)

{"created": 1, "updated": 0, "total": 1}

Hibaválaszok

POST/api/webhooks/order

Új rendelést fogad egy csatlakoztatott webshoptól. Az API ellenőrzi az SKU-kat, megvizsgálja a készletet, és rendelésrekordot hoz létre feldolgozásra.

Védett Írás

Kéréstörzs (Content-Type: application/json)

Az items tömb elemei

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  -X POST https://haszno.com/api/webhooks/order \
  -H 'Content-Type: application/json' \
  -d '{
    "externalId": "SHOP-20261112-001",
    "customerName": "Kiss Éva",
    "address": "1111 Budapest, Példa utca 1.",
    "items": [
      {"sku": "ABC-001", "qty": 2}
    ]
  }'

Válasz (201)

{"id": 1047}

Hibaválaszok

PUT/api/settings

Frissíti a bolt globális árazási szabályait. Minden mező opcionális; ha kihagyod, az aktuális értéke változatlan marad.

Védett Írás

Kéréstörzs (Content-Type: application/json)

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  -X PUT https://haszno.com/api/settings \
  -H 'Content-Type: application/json' \
  -d '{
    "undercutPct": 2,
    "minMarginPct": 15,
    "shippingMarkets": ["HU", "SK"]
  }'

Válasz (200)

Visszaadja a frissített beállítássort. Ugyanolyan séma, mint a GET /api/settings esetén (valódi példányon a demo mező nélkül).

{
  "id": 1,
  "undercutPct": 2,
  "minMarginPct": 15,
  "vatPct": 27,
  "shippingMarkets": ["HU", "SK"],
  "automationPaused": false
}

PATCH/api/products/:id

Frissíti egy termék piaci áradatait, vagy kézi bruttó árfelülbírálatot állít be.

Védett Írás

Útvonalparaméterek

Kéréstörzs (Content-Type: application/json)

Minden mező opcionális. Csak a módosítani kívánt mezőket küldd el.

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  -X PATCH https://haszno.com/api/products/101 \
  -H 'Content-Type: application/json' \
  -d '{"priceGross": 2990}'

Válasz (200)

Visszaadja a frissített termékrekordot. Ugyanolyan séma, mint a GET /api/products egyetlen eleme.

POST/api/products/apply-prices

Alkalmazza az ajánlott árat a listázott termékekre. Alapértelmezés szerint az összes listázott termékre alkalmazza. Opcionálisan azonosítók vagy beszállító alapján szűkíthető.

Védett Írás

Kéréstörzs (Content-Type: application/json)

Minden mező opcionális.

Kérés

# Alkalmazás az összes listázott termékre:
curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  -X POST https://haszno.com/api/products/apply-prices \
  -H 'Content-Type: application/json' \
  -d '{}'

# Alkalmazás csak megadott termékekre:
curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  -X POST https://haszno.com/api/products/apply-prices \
  -H 'Content-Type: application/json' \
  -d '{"ids": [101, 102, 103]}'

Válasz (200)

{"changed": 847, "total": 1400}

GET/api/rules

Visszaadja a bolthoz konfigurált összes automatizálási szabályt.

Védett Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  https://haszno.com/api/rules

Válasz (200)

Szabályobjektumok tömbjét adja vissza.

A trigger enum értékei

A conditions elem almezői

Az actions elem almezői

[
  {
    "id": 5,
    "name": "Veszteséges termékek javaslata",
    "enabled": true,
    "trigger": "market_price",
    "conditions": [
      {"field": "current.marginPct", "op": "lt", "value": 0}
    ],
    "actions": [
      {"type": "propose_price"}
    ],
    "template": "loss-guard",
    "createdAt": "2026-10-01T10:00:00.000Z"
  }
]

GET/api/network/suppliers

Visszaadja a Haszno hálózatában elérhető összes beszállítót, valamint a bolt csatlakozási állapotát mindegyikhez.

Védett Csak olvasás

Paraméterek

Nincsenek.

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  https://haszno.com/api/network/suppliers

Válasz (200)

Hálózati-beszállítóobjektumok tömbjét adja vissza.

[
  {
    "id": 7,
    "name": "Minta Kft.",
    "category": "kert",
    "country": "HU",
    "productCount": 340,
    "connected": false,
    "avgResellerMarginPct": 28.4
  }
]

POST/api/products/:id/listing

Listázza vagy leveszi a listáról az adott terméket. Ha korábban listáról levett terméket listáz fel, a priceGross automatikusan az aktuális recommended.priceGross értékre áll be.

Védett Írás

Útvonalparaméterek

Kéréstörzs (Content-Type: application/json)

Kérés

curl --fail-with-body \
  -u "$HASZNO_BASIC" \
  -X POST https://haszno.com/api/products/101/listing \
  -H 'Content-Type: application/json' \
  -d '{"listed": true}'

Válasz (200)

Visszaadja a frissített termékrekordot. Ugyanolyan séma, mint a GET /api/products egyetlen eleme. A listed mező az új állapotot tükrözi, a priceGross pedig a listázáskor automatikusan alkalmazott ajánlott árat.

{
  "id": 101,
  "listed": true,
  "priceGross": 2090,
  "recommended": {
    "priceGross": 2090,
    "status": "versenykepes"
  }
}