Creditcheck WS - všeobecná doporučení a limitace
Úvod
Pro využívání Creditcheck webové služby našimi zákazníky doporučujeme určitá pravidla a limitace pro přístup k jednotlivým metodám. Důvodem pro tyto doporučení je snaha o optimalizaci běhu této služby na naší straně (maximální využití a nepřetěžování dostupných prostředků), ale hlavně pro naše zákazníky (rychlá odezva, eliminace timeoutů).
Creditcheck může na využívání této webservice uplatnit politiku přiměřeného využívání proto, aby zajistil, že všichni zákazníci budou mít při využívání metody zajištěnu její dostupnost a zabránil jejímu zneužívání.
Všeobecná doporučení
Před implementací Creditcheck webové služby, doporučujeme se obeznámit s nabízenými metodami v naší dokumentaci. Každá metoda je určena pro specifickou potřebu a i když stejné potřeby lze někdy docílit pomocí několika metod, je optimální využít metodu k Vašemu účelu přizpůsobenou a optimalizovanou.
Jako lehké shrnutí je zde pár příkladů:
Pro stahování Creditcheck semaforu postačuje 1x denně využívat jednu z metod:
Pro stahování informací o subjektech s IČ (právnické osoby a fyzické osoby podnikající) slouží metoda:
Tato metoda je dále přizpůsobitelná v rámci konkrétního uživatelského účtu. Více informací najdete v dokumentaci.
Pro stahování informací o fyzických osobách (identifikace podle Jména, Příjmení, Data narození, alternativně podle RČ) slouží metoda:
Creditcheck webová služba nabízí množství dalších metod, které zde nejsou zmíněny. Informace ke všem metodám naleznete v dokumentaci.
Limitace webové služby
“Rozestup” (prodleva mezi jednotlivými dotazy)
Globální limitací, která platí pro všechny metody je adekvátní “rozestup” mezi jednotlivými Requesty. Cílem je, aby webová služba nebyla “bombardována” požadavky v rychlém sledu a tím pádem nedocházelo k timeoutu požadavků, které přesahují povolenou velikost “fronty”.
U implementací kde požadavky vznikají na základě manuální akce operátora (například kliknutí na tlačítko v ERP systému apod.) není potřeba tento “rozestup” řešit.
Přínosem je, pokud se podaří vyřešit potenciální duplicitní požadavky vznikající na straně zákazníka např.
kliknutí “omylem” na stejnou akci vícekrát po sobě.
Nebo “současné” vyvolání akce více operátory v rychlém sledu po sobě
U implementací kde jsou požadavky generovány automatizovaným systémem (např. na základě nějaké množiny subjektů, kterou zákazník potřebuje prověřit) je doporučováno dodržovat co nejdelší “rozestup”, který je zároveň ve shodě s Vaší potřebou získávat data.
Příklad:
Představme si, že zákazník potřebuje aktualizovat ve své databázi informace o exekucích, dluzích a insolvencích každý den a to u zájmové množiny 10 000 subjektů (právnických osob).
Již první možnou optimalizací je, domluvit si s naší zákaznickou péčí “ořezání” výstupu metody GetSubjectFullReport tak, aby vracela pouze údaje pro zákazníka potřebné.
Pracujeme s časovým oknem 24 hodin a tohoto cíle lze docílit různou frekvencí dotazování.
V případě, že uživatel připraví napojení webové služby tak, že každý den o půlnoci začne posílat 1 dotaz každou sekundu. Bude mít cíl splněn za necelé 3 hodiny. Nicméně bude existovat velká pravděpodobnost, že se některé jeho dotazy potkají s dotazy dalších zákazníků (nebo bude Creditcheck služba vytížena jiným způsobem) a tím pádem u části jeho dotazů dojde k timeoutu nebo chybě.
Alternativně může zákazník rozložit dotazování na 1 dotaz každých řekněme 5 sekund. Tímto tempem bude cíl splněn za necelých 14 hodin. A je mnohem větší pravděpodobnost, že během zpracování nedojde k žádné chybě ani timeoutu.
Snažte se prosím dodržovat “rozestup” mezi jednotlivými dotazy alespoň 5 sekund. Pokud by taková limitace byla v rozporu s Vašimi potřebami, kontaktujte prosím naše oddělení zákaznické péče na helpdesk@creditcheck.cz a probereme s Vámi možnosti.
Ideální časové okno pro využívání webové služby
Jako u předchozí limitace, i zde platí, že pro implementace kde požadavky vznikají na základě manuální akce operátora není potřeba ani možné tuto limitaci řešit.
U automatizovaného zpracování doporučujeme využívat časové okno snížené zákaznické aktivity, které začíná cca. od 18:00 hodiny a končí následující den v 06:00.
Pokud pro Vaši potřebu nepostačuje toto časové okno 12 hodin během noci, nic se neděje. Creditcheck webovou službu můžete samozřejmě využívat i během dne, snažte se prosím dodržovat alespoň limitaci Rozestup.