Áradat-API — érje el a figyelési adatokat a saját rendszereiből
A 4pricing.net REST API-jával a műszaki csapata átveheti az árfigyelési adatokat a saját rendszereibe (például ERP-be, WMS-be vagy webáruházba). A 4pricing nem kínál kész csatlakozókat: a kapcsolatot a fejlesztője építi meg az API-ra. A hitelesítés API-kulccsal történik, a válaszok szabványos JSON formátumúak, a specifikáció pedig OpenAPI 3.0 formában közzétett, így közvetlenül importálható a kliensébe.
Fő végpontok
Az API a figyelt termékek szintjén teszi elérhetővé az adatokat: a terméklistát az aktuális árral, egyetlen termék ártörténetét, valamint a listanézetekhez szánt tömeges mini-történetet. A termékeket a hozzáadáskor visszaadott product_id azonosítja — ez az útvonalkulcs. Az összegek a legkisebb pénzegységben érkeznek, a current_price_cents és a price_cents mezőkben, a pénznemmel együtt, és minden rekord tartalmazza az ellenőrzés pontos idejét (last_scraped_at, illetve scraped_at).
- GET /products/ — a figyelt termékei, aktuális árral és pénznemmel
- GET /products/{product_id}/history — egy termék ártörténete, időbélyegekkel
- GET /products/sparklines — tömeges mini-történet, termékenként egy ársorral
- POST /alerts/ — riasztás létrehozása (küszöbérték, százalékos esés, készlet, versenytárs)
Hitelesítés és kéréskorlátozás
A hitelesítés az X-API-Key fejléccel történik, vagy ezzel egyenértékűen az Authorization: Bearer fejléccel, ugyanazzal a kulccsal. A kulcsokat a vezérlőpultban, az API és kulcsok részben hozhatja létre, és a teljes érték csak egyszer, a létrehozáskor jelenik meg. A korlát fiókonként 60 kérés percenként, amelyen az összes kulcsa osztozik; efölött az API 429 választ ad, és elküldi a Retry-After fejlécet.
Előnyök és korlátok
Előnyök
- A csapata közvetlenül az API-ból táplálhatja a saját ERP-jét vagy WMS-ét kézi CSV-export nélkül (a csatlakozót Ön építi meg)
- A riasztások webhookon is érkezhetnek, így nem kell lekérdezgetnie
- Közzétett OpenAPI 3.0 specifikáció, amelyet közvetlenül importálhat a kliensébe
- Hozzáférés az összehasonlítási csoportra ajánlott árhoz, nem csak a nyers adatokhoz
Korlátok
- A fiókonkénti 60 kérés/perc korlát (az összes kulcs között megosztva) nagy kínálatnál tömeges lekérdezést és helyi gyorsítótárazást igényel
- A webhookhoz nyilvános http/https URL (80/443-as port) kell az Ön infrastruktúrájában
Rövid értékelés
Az API lefedi a figyelési adatok és az ajánlott ár lekérdezését, a saját árak beküldését és az ajánlott ár alkalmazását, de nem tartalmaz csatlakozókat ERP-hez vagy webáruházhoz. Nagy kínálatnál érdemes tömeges lekérdezést (lapozás, tömeges mini-történet) és helyi gyorsítótárazást használni.
Specifikációs táblázat
| Végpont | Metódus | Válasz |
|---|---|---|
| /products/ | GET | JSON-tömb a figyelt termékekről, current_price_cents mezővel |
| /products/{product_id}/history | GET | JSON-tömb az ártörténetről, időbélyegekkel |
| /products/sparklines | GET | JSON, termékenként egy ársorral |
| /alerts/ | POST | A létrehozott riasztás, típusával és küszöbértékével |
API és igény szerinti CSV-export
| Szempont | REST API | CSV-export |
|---|---|---|
| Adatkésleltetés | Az adat annyi idős, mint a legutóbbi ellenőrzés | A letöltés pillanatának megfelelő adat |
| Kapcsolat az ERP-vel | HTTP-n keresztül, a csapata által írt csatlakozóval | Kézi vagy ütemezett import |
| Push-riasztások | Igen (webhook) | Nem |
Gyakori kérdések
Hogyan szerzek API-kulcsot?
A kulcsot a 4pricing.net fiókja vezérlőpultjában, az API és kulcsok részben hozhatja létre. A teljes kulcsérték csak egyszer, a létrehozáskor jelenik meg — ha elveszíti, vonja vissza a kulcsot, és hozzon létre újat.
Elérhetem egyszerre az összes termék adatait?
Igen, a GET /products/?skip=0&limit=200 hívással lapozhatja végig a teljes figyelt kínálatot; a sorok teljes száma az X-Total-Count fejlécben érkezik. Hosszú listákhoz a GET /products/sparklines egyetlen hívásban adja vissza több termék mini-történetét. Nagy kínálatnál éjszakai szinkronizálást javaslunk, és gyakoribb lekérdezést csak a fontos termékekre.
Milyen formátumú az API által visszaadott ártörténet?
Egy JSON-tömb {product_id, price_cents, currency, in_stock, scraped_at} objektumokkal, dátum szerint csökkenő sorrendben. Az ár a legkisebb pénzegységben (price_cents) érkezik, nem egész pénznemben, a scraped_at pedig pontos ISO 8601 időbélyeg.
Milyen eseményeket küld a webhook?
Fiókonként egy webhook-URL van, és ez fogad minden Ön által létrehozott riasztástípust: küszöb alatti ár, küszöb feletti ár, százalékos esés, készletre visszatérés, versenytárs alákínálása és a legalacsonyabb ár pozíciójának elvesztése. Magára a költségküszöbre nincs riasztás.