API cenových údajov — prístup k údajom z monitoringu z vlastných systémov
REST API platformy 4pricing.net umožňuje vášmu tímu čítať údaje z monitoringu cien a prepájať ich s vlastnými systémami (ERP, WMS, e-shopová platforma). Hotové konektory neexistujú — prepojenie sa vyvíja nad API. Autentifikácia prebieha kľúčom API, odpovede majú štandardný formát JSON a špecifikácia je zverejnená ako OpenAPI 3.0, ktorú môžete rovno importovať do svojho klienta.
Hlavné endpointy
API sprístupňuje údaje monitoringu na úrovni sledovaného produktu: zoznam produktov s aktuálnou cenou, históriu cien jedného produktu a hromadnú mini-históriu pre zobrazenie v zoznamoch. Produkty sa identifikujú hodnotou product_id, ktorú dostanete pri ich pridaní — URL adresa produktu slúži na jeho pridanie, nie ako kľúč v ceste. Sumy prichádzajú v najmenších jednotkách meny, v poliach current_price_cents a price_cents, spolu s menou, a každý záznam nesie presný čas kontroly (last_scraped_at, resp. scraped_at).
- GET /products/ — vaše sledované produkty s aktuálnou cenou a menou
- GET /products/{product_id}/history — história cien jedného produktu s časovými pečiatkami
- GET /products/sparklines — hromadná mini-história, jeden riadok cien na produkt
- POST /alerts/ — vytvorenie upozornenia (prah, percentuálny pokles, sklad, konkurent)
Autentifikácia a obmedzenie frekvencie
Autentifikácia prebieha cez hlavičku X-API-Key alebo rovnocenne cez Authorization: Bearer s tým istým kľúčom. Kľúče sa generujú v paneli, v sekcii API a kľúče, pričom celá hodnota sa zobrazí iba raz, pri vytvorení. Limit je 60 požiadaviek za minútu na účet, spoločný pre všetky vaše kľúče; pri jeho prekročení API odpovie kódom 429 a pošle hlavičku Retry-After.
Výhody a obmedzenia
Výhody
- Cez API ho možno prepojiť s ERP/WMS bez manuálneho exportu do CSV — vývoj zabezpečuje váš tím, hotové konektory neexistujú
- Upozornenia možno doručovať webhookom, takže nemusíte dáta neustále dopytovať
- Zverejnená špecifikácia OpenAPI 3.0, ktorú rovno importujete do svojho klienta
- Prístup k odporúčanej cene pre porovnávaciu skupinu, nielen k surovým údajom
Obmedzenia
- Limit 60 požiadaviek za minútu na účet (spoločný pre všetky kľúče) si pri rozsiahlych katalógoch vyžaduje hromadné čítanie a lokálne ukladanie do vyrovnávacej pamäte
- Webhook vyžaduje verejnú http/https URL adresu (port 80/443) vo vašej infraštruktúre
Stručný záver
API pokrýva bežné scenáre na vytvorenie vlastného prepojenia s vašimi systémami. Katalógom s viac než 50 000 aktívnymi SKU sa oplatí hromadné čítanie a lokálna vyrovnávacia pamäť.
Tabuľka špecifikácií
| Endpoint | Metóda | Odpoveď |
|---|---|---|
| /products/ | GET | Pole JSON so sledovanými produktmi, s current_price_cents |
| /products/{product_id}/history | GET | Pole JSON s históriou a časovými pečiatkami |
| /products/sparklines | GET | JSON s jedným riadkom cien na produkt |
| /alerts/ | POST | Vytvorené upozornenie s jeho typom a prahom |
API verzus export do CSV na požiadanie
| Kritérium | REST API | Export do CSV |
|---|---|---|
| Oneskorenie údajov | Údaje sú také staré ako posledná kontrola | Údaje k okamihu stiahnutia |
| Prepojenie s ERP | Vytvorí ho váš tím cez HTTP (bez hotového konektora) | Manuálny import alebo cez cron |
| Push upozornenia | Áno (webhook) | Nie |
Časté otázky
Ako získam kľúč API?
Kľúč si vygenerujete v paneli svojho účtu 4pricing.net, v sekcii API a kľúče. Celá hodnota kľúča sa zobrazí iba raz, pri vytvorení — ak ju stratíte, kľúč zrušte a vygenerujte nový.
Môžem pristupovať k údajom o všetkých produktoch naraz?
Áno, cez GET /products/?skip=0&limit=200 prelistujete celý sledovaný katalóg; celkový počet riadkov prichádza v hlavičke X-Total-Count. Pri dlhých zoznamoch vráti GET /products/sparklines mini-históriu viacerých produktov v jedinom volaní. Pri rozsiahlych katalógoch odporúčame nočné čítanie, ktoré si naplánujete sami, a častejšie čítanie len pri produktoch, na ktorých vám záleží.
Aký formát má história cien vrátená cez API?
Pole JSON s objektmi {product_id, price_cents, currency, in_stock, scraped_at}, zoradené zostupne podľa dátumu. Cena prichádza v najmenších jednotkách meny (price_cents), nie v celých jednotkách, a scraped_at je presná časová pečiatka podľa ISO 8601.
Aké udalosti webhook odosiela?
Na jeden účet pripadá jedna URL adresa webhooku, ktorá prijíma každý typ upozornenia, ktorý vytvoríte: cena pod prahom, cena nad prahom, percentuálny pokles, návrat na sklad, konkurent, ktorý vás podliezol, a strata pozície s najnižšou cenou. Upozornenie na nákladovú hranicu ako takú neexistuje.