Bidding API
O produkte
Bidding API je služba Heureky, ktorá poskytuje aktuálne údaje z produktového katalógu Heureky. Dôležité informácie pre efektívne bidovanie, ktoré sú vidieť na produktovom detaile sú súčasťou API.
Cieľ
Viac ako polovica výkonovej kapacity serverov Heureky je spotrebovaná robotickým prechádzaním webu Heureky. Crawlovanie webu Heureky chceme obmedziť a poskytnúť náhradu v podobe plateného API s pridanou hodnotou.
Dokumentácia API
Vždy aktuálna dokumentácia k API je na adrese. https://api.heureka.cz/bidding_api/v1/apidoc
Dokumentácia obsahuje štruktúry volaní a odpovedí s príkladmi vrátených výsledkov. Možné návratové hodnoty jednotlivých atribútov sú viditeľné v záložke “Structure”. Stromová štruktúra je rozbaľovacia po kliknutí a obsahuje hint nápovedu po nabehnutí myšou. Interaktívne je možné vykonať volanie na API po vyplnení Vám prideleného tokenu do kľúča access_key.
Endpointy pre volanie API
Katalóg Heureka.cz https://api.heureka.cz/bidding_api/v1/apidoc
Katalóg Heureka.sk https://api.heureka.sk/bidding_api/v1/apidoc
Implementácia na strane klienta
JSON-RPC je bezstavový protokol pre vzdialené volanie procedúr (RPC). Na implementáciu rozhrania API na vašej strane môžete použiť dostupné knižnice pre programovací jazyk.
V prípade jazyka Python sa môžete inšpirovať ukážkou nižšie. Na komunikáciu s našími servermi API vám pridelíme kľúč, ktorý v parametroch použijete ako atribút access_key.
https://pypi.org/project/json-rpc
Cache na strane Heureky
Kvôli zlepšeniu rýchlosti odpovedí sú na strane Heureky počas 1 hodiny cachované dáta ceny prepravy a výpis kategórii v metóde category.index.
Limity
Servery sú hostované mimo cloudu a nie sú nafukovacie. Minútový limit počtu volaní pre každý kľúč je 10 000, aby sa zabránilo špičkovému zaťaženiu clustera. Budeme radi, ak sa vám podarí rozložiť volania API plynule v čase.
Notifikácia
V priebehu mesiaca vám budeme posielať notifikácie o priebežnom stave počtu volaní API pre váš kľúč.
Fakturácia
Spätne za predchádzajúci mesiac vám budeme posielať generované faktúry za počet volaní API podľa využitej tarify.
FAQ – najčastejšie otázky
Ako prebieha aktivácia API?
Najprv je potrebné potvrdiť zmluvu na objednávku tejto služby, potom vám bude poskytnutý prístup/token, dokumentácia a ďalšie potrebné informácie. Následne stačí implementovať API.
Bude mi chodiť notifikácia o priebežnom stave volania?
Áno, bude. Do e-mailu vám bude chodiť týždenný report s počtom volaní.
Máte o Bidding API záujem, alebo máte doplňujúce otázky? Neváhajte ma kontaktovať na e-maile: [email protected].