Pólónagyker API: élő készlet és nagyker árak a saját rendszeredben

Ne emailben kérd a készletet, és ne másold kézzel a termékeket. Az API valós időben adja a teljes terméktörzset, a raktárkészletet és a fiókodhoz tartozó nagyker árakat: webshopba, ERP-be, bármibe.

Regisztráció Bejelentkezés

GET /api/v1/stock-feed

{
  "data": [{
    "sku": "00123-M",
    "title": "Póló M",
    "base_sku": "00123",
    "internal_quantity": 120,
    "internal_restock_date": null,
    "external_quantity": 500,
    "external_restock_date": "2026-10-20"
  }],
  "meta": {
    "generated_at": "2026-10-06T12:00:00+00:00",
    "total": 1
  }
}

Mit tud az API?

Teljes terméktörzs

Minden termékcsalád és variáns: méret, szín, méretadatok, kép, kategória és márka, magyarul és angolul.

Élő raktárkészlet

Raktárankénti darabszám és várható beérkezés, mindig az aktuális állapot. Nincs többé telefonos készletkérdezés.

Saját ársávos árak

Pontosan azt az árat kapod, amit a fiókod a webshopban is lát, a hozzád rendelt nagyker ársáv szerint.

Egyszerű REST + JSON

Szabványos REST, Bearer vagy X-API-Key hitelesítés, lapozott terméklisták és teljes JSON/CSV készletfeed, dokumentációval.

Hogyan működik?

Regisztrálj vagy jelentkezz be

Az API-t minden regisztrált Pólónagyker fiók ingyenesen használhatja.

Generálj API kulcsot

A fiókodon belül, az API kulcsok oldalon. Legfeljebb 5 kulcsod lehet, bármikor törölheted vagy újragenerálhatod őket.

Csatlakozz

Hívd a végpontokat a kulcsoddal, és dolgozz az élő adatokkal a saját rendszeredben.

curl https://polonagyker.hu/index.php/api/v1/base-products \
  -H "Authorization: Bearer {kulcs}"

Elérhető végpontok

GET /api/v1/stock-feed Teljes élő készletlista JSON vagy CSV formátumban
GET /api/v1/base-products Termékcsaládok listája, lapozással
GET /api/v1/base-products/{id} Egy termékcsalád részletei
GET /api/v1/base-products/{id}/products Variánsok (méret, szín, ár) listája
GET /api/v1/products/{id}/stocks Variáns készletadatai raktáranként
GET /api/v1/categories Kategóriafa
GET /api/v1/brands Márkák

Hitelesítés: Bearer vagy X-API-Key Alaplimit: 60 kérés / perc fiókonként Formátum: JSON (hu / en), készletfeed: JSON / CSV

Teljes élő készletfeed

Egyetlen hitelesített kérés az összes közzétett variáns készletét visszaadja, nulla készletnél is. Nincs lapozás vagy szűrés. A visszavont és törölt termékek eltűnnek a teljes listából, ezért frissítéskor cseréld le a korábbi listát.

Az élő adat a webshop adatbázisának aktuális, mentett készlete: az importok, a kézi módosítások és a webshopos rendelések háttérben végzett belsőkészlet-levonása után. Nem közvetlen kapcsolat a raktári rendszerrel, és nem 15 percenként generált fájl.

GET
            https://polonagyker.hu/index.php/api/v1/stock-feed

GET
            https://polonagyker.hu/index.php/api/v1/stock-feed?format=csv

Alapból JSON érkezik; a format=json ugyanezt adja, a format=csv CSV-letöltést. Más formátum 422-es JSON-hibát ad. A data a teljes lista, a meta.generated_at a válasz UTC-időpontja, a meta.total a sorok száma.

A meglévő kulcsot Authorization: Bearer vagy X-API-Key fejlécben küldd, soha ne az URL-ben. A feed is a többi API-kéréssel közös limitet használja: alapból 60 kérés percenként, fiókonként. Hiányzó vagy érvénytelen kulcs: 401; limit túllépése: 429.

sku: Variáns cikkszáma, szövegként.
title: Variáns neve, a választott API-nyelven.
base_sku: Alaptermék cikkszáma, szövegként.
internal_quantity: Belső készlet, egész darabszám.
internal_restock_date: Belső várható beérkezés: YYYY-MM-DD vagy null.
external_quantity: Külső készlet, egész darabszám.
external_restock_date: Külső várható beérkezés: YYYY-MM-DD vagy null.

Hiányzó készletsornál a mennyiség 0, a beérkezés null. Több azonos típusú raktárnál a mennyiségek összeadódnak, a beérkezések közül a legkorábbi dátum szerepel.

JSON- és CSV-példa

curl "https://polonagyker.hu/index.php/api/v1/stock-feed" \
  -H "X-API-Key: kulcs"

curl "https://polonagyker.hu/index.php/api/v1/stock-feed?format=csv" \
  -H "Authorization: Bearer kulcs"

JSON-válasz példa

{
  "data": [{
    "sku": "00123-M",
    "title": "Póló M",
    "base_sku": "00123",
    "internal_quantity": 120,
    "internal_restock_date": null,
    "external_quantity": 500,
    "external_restock_date": "2026-10-20"
  }],
  "meta": {
    "generated_at": "2026-10-06T12:00:00+00:00",
    "total": 1
  }
}

sku,title,base_sku,internal_quantity,internal_restock_date,external_quantity,external_restock_date
00123-M,Póló M,00123,120,,500,2026-10-20

A CSV UTF-8 kódolású, vesszővel elválasztott, szabványosan idézett adat. A hiányzó dátum üres cella. Képletnek értelmezhető szöveg elé biztonsági aposztróf kerül; a JSON az eredeti szöveget adja. A két cikkszámoszlopot szövegként importáld, hogy a kezdő nullák megmaradjanak.

Excel Power Query: hitelesített frissítés

Az Excelben válaszd az Adatok > Adatok lekérése > Egyéb forrásokból > Üres lekérdezés menüpontot.
A Power Query szerkesztőben a Paraméterek kezelése menüben hozz létre egy ApiKey nevű, Szöveg típusú paramétert, és add meg a saját API-kulcsodat.
A Speciális szerkesztőben illeszd be az alábbi JSON-lekérdezést. Ha az Excel hitelesítési módot kér, a webcímhez válaszd a Névtelen módot: az API-kulcsot a kód küldi a fejlécben.
Válaszd a Bezárás és betöltés lehetőséget. A későbbi Adatok > Az összes frissítése újra lekéri a teljes készletlistát. A kulcsot tartalmazó munkafüzetet csak annak add tovább, aki használhatja az API-t.

let
    Source = Json.Document(Web.Contents("https://polonagyker.hu/index.php", [
        RelativePath = "api/v1/stock-feed",
        Headers = [#"X-API-Key" = ApiKey]
    ])),
    Rows = Table.FromRecords(Source[data], {
        "sku", "title", "base_sku", "internal_quantity", "internal_restock_date",
        "external_quantity", "external_restock_date"
    }),
    Typed = Table.TransformColumnTypes(Rows, {
        {"sku", type text}, {"title", type text}, {"base_sku", type text},
        {"internal_quantity", Int64.Type}, {"internal_restock_date", type date},
        {"external_quantity", Int64.Type}, {"external_restock_date", type date}
    })
in
    Typed

CSV használata Power Queryben

CSV esetén a fenti kód Source és Rows lépését cseréld az alábbira; a Typed lépés és az ApiKey paraméter változatlan.

    Source = Csv.Document(Web.Contents("https://polonagyker.hu/index.php", [
        RelativePath = "api/v1/stock-feed",
        Query = [format = "csv"],
        Headers = [#"X-API-Key" = ApiKey]
    ]), [Delimiter = ",", Encoding = 65001, QuoteStyle = QuoteStyle.Csv]),
    Promoted = Table.PromoteHeaders(Source, [PromoteAllScalars = true]),
    Rows = Table.ReplaceValue(Promoted, "", null, Replacer.ReplaceValue,
        {"internal_restock_date", "external_restock_date"}),

Generálj egy kulcsot, és kérdezd le az első terméket

Hozz létre egy API kulcsot a fiókodban, másold a kódodba, és pár perc múlva már az élő készletet meg az árakat kérdezed. A teljes dokumentáció egy kattintásra.

Regisztráció API dokumentáció