API cenových dat — přístup k datům monitoringu z vašich vlastních systémů
REST API 4pricing.net umožňuje vašemu technickému týmu převzít data z monitoringu cen do vlastních systémů (například ERP, WMS nebo e-shopu). 4pricing nenabízí hotové konektory: propojení si nad API postaví váš vývojář. Autentizace probíhá pomocí klíče API, odpovědi jsou ve standardním formátu JSON a specifikace je zveřejněna jako OpenAPI 3.0, kterou můžete rovnou naimportovat do svého klienta.
Hlavní endpointy
API zpřístupňuje data monitoringu na úrovni sledovaného produktu: seznam produktů s aktuální cenou, historii cen jednoho produktu a hromadnou mini-historii pro přehledová zobrazení. Produkty se identifikují podle product_id vráceného při jejich přidání — ten je klíčem v cestě. Částky přicházejí v nejmenších jednotkách měny, v polích current_price_cents a price_cents, spolu s měnou, a každý záznam nese přesný čas kontroly (last_scraped_at, resp. scraped_at).
- GET /products/ — vaše sledované produkty s aktuální cenou a měnou
- GET /products/{product_id}/history — historie cen jednoho produktu s časovými razítky
- GET /products/sparklines — hromadná mini-historie, jedna řada cen na produkt
- POST /alerts/ — vytvoření upozornění (prahová hodnota, procentní pokles, sklad, konkurent)
Autentizace a omezení počtu požadavků
Autentizace používá hlavičku X-API-Key nebo rovnocenně Authorization: Bearer se stejným klíčem. Klíče se generují v panelu, v sekci API a klíče, a úplná hodnota se zobrazí jen jednou, při vytvoření. Limit je 60 požadavků za minutu na účet, sdílený všemi vašimi klíči; nad něj API odpovídá kódem 429 a posílá hlavičku Retry-After.
Výhody a omezení
Výhody
- Váš tým může vlastní ERP/WMS napájet přímo z API bez ručního exportu do CSV (konektor si postavíte sami)
- Upozornění lze doručovat podepsaným webhookem, takže nemusíte data neustále dotazovat
- Zveřejněná specifikace OpenAPI 3.0, kterou rovnou naimportujete do svého klienta
- Přístup k doporučené ceně pro srovnávací skupinu, nejen k surovým datům
Omezení
- Limit 60 požadavků/minutu na účet (sdílený všemi klíči) si u rozsáhlých katalogů vyžádá hromadné čtení a lokální mezipaměť
- Webhook vyžaduje veřejnou adresu URL http/https (port 80/443) ve vaší infrastruktuře
Stručný závěr
API pokrývá čtení dat z monitoringu a doporučené ceny, odesílání vlastních cen i použití doporučené ceny, ale nedodává konektory pro ERP ani e-shop. Velkým katalogům prospěje hromadné čtení (stránkování, hromadná mini-historie) a lokální mezipaměť.
Tabulka specifikací
| Endpoint | Metoda | Odpověď |
|---|---|---|
| /products/ | GET | Pole JSON se sledovanými produkty, s current_price_cents |
| /products/{product_id}/history | GET | Pole JSON s historií a časovými razítky |
| /products/sparklines | GET | JSON s jednou řadou cen na produkt |
| /alerts/ | POST | Vytvořené upozornění s jeho typem a prahovou hodnotou |
API vs. export do CSV na vyžádání
| Kritérium | REST API | Export do CSV |
|---|---|---|
| Zpoždění dat | Data jsou stará jako poslední kontrola | Data k okamžiku stažení |
| Propojení s ERP | Přes HTTP, konektor si píše váš tým | Ruční import nebo přes cron |
| Push upozornění | Ano (webhook) | Ne |
Časté dotazy
Jak získám klíč k API?
Klíč si vygenerujete v panelu svého účtu 4pricing.net, v sekci API a klíče. Úplná hodnota klíče se zobrazí jen jednou, při vytvoření — pokud ji ztratíte, klíč zneplatněte a vygenerujte nový.
Mohu získat data ke všem produktům najednou?
Ano, GET /products/?skip=0&limit=200 umožňuje stránkovat celý sledovaný katalog; celkový počet řádků přichází v hlavičce X-Total-Count. U dlouhých seznamů vrátí GET /products/sparklines mini-historii několika produktů v jediném volání. U rozsáhlých katalogů doporučujeme noční synchronizaci a častější čtení jen u produktů, na kterých vám záleží.
V jakém formátu vrací API historii cen?
Jako pole JSON s objekty {product_id, price_cents, currency, in_stock, scraped_at}, seřazené sestupně podle data. Cena je v nejmenších jednotkách měny (price_cents), nikoli v celých jednotkách, a scraped_at je přesné časové razítko ve formátu ISO 8601.
Jaké události webhook odesílá?
Na účet připadá jedna adresa URL webhooku a ta přijímá každý typ upozornění, který vytvoříte: cena pod prahovou hodnotou, cena nad prahovou hodnotou, procentní pokles, návrat skladem, konkurent, který vás podbídl, a ztráta pozice s nejnižší cenou. Upozornění přímo na nákladovou hranici neexistuje.