Alertviz Příručky English
← Připojení k EuroKYB

EuroKYB REST API

Načtěte ověření přímo do účetního programu nebo skriptu. Služba vrací JSON. Ze seznamu cest v OpenAPI můžete vybrat českou firmu, evropské DIČ, IBAN, kurz ČNB, platební QR nebo kontrolu veřejné stránky.

Příklad toku od dotazu na IČO přes registr až k polím ve výsledném JSON.

Postup

  1. V terminálu nastavte základní adresu jako v příkladu. Požadavkem na /v1/quota si zdarma přečtěte remaining (zbývající počet) a resetsAt (obnovení limitu).
  2. Zavolejte /v1/cz/kyb s IČO jako textem. U klíče předplatného přidejte hlavičku X-API-Key se svým klíčem. Uchovávejte jej na serveru nebo v úložišti přihlašovacích údajů.
  3. Zpracujte stav HTTP i obsah odpovědi. U 429 počkejte podle hlavičky Retry-After. Při 401 zkontrolujte platnost klíče.

Vyzkoušejte

BASE=https://alertviz.com/api/eurokyb
curl -sS "$BASE/v1/quota"
curl -sS "$BASE/v1/cz/kyb?ico=00094943"

Jak číst výsledek

Ve výpisu porovnejte companyName a publishedBankAccounts s fakturou. Stav UNKNOWN vyžaduje další ověření. Nové klíče Pro zahrnují 1 000 dokončených kontrol měsíčně, Business 5 000. Oba tarify mají strop 300 za minutu.