Jak začít s API?

> [HTML Version](jakzacitsapiv2.html)

Jestliže máte zájem využívat Dotykačka API v2, je nutné postupovat podle níže uvedených kroků a v první řadě si prostřednictvím formuláře požádat o vygenerování autorizačních údajů (`Client ID` a `Client Secret`). Ty jsou nezbytné pro komunikaci s API rozhraním.

API rozhraní je dostupné zákazníkům s [licencí NAPLNO a NEOMEZENĚ](verzedotykacky.md). Pro testovací účely od nás dostanete speciální testovací licenční klíč. Tímto klíčem [aktivujete](aktivace.md) pokladní aplikaci Dotykačka a dojde tak k vytvoření testovacího cloudu. Testování tedy neprovádíte na živých datech.



# 1. krok: Žádost o přístup k API v2

Pro komunikaci s rozhraním API v2, je nutné vyplnit tento [registrační formulář](https://forms.gle/8whvKw1zgK8KptnG7) klientské aplikace. Na základě pečlivě vyplněného formuláře vás budeme do 110 pracovních dnů kontaktovat, abychom zjistili případné další údaje o vaší aplikaci a vydali vám` Client ID` a `Client Secret`, které jsou nezbytné pro používání API.

Dále vám poskytneme testovací licenční klíč. Tento licenční klíč použijete pro vytvoření testovacího cloudu a testování vaší integrace.

| | |
|------|------|
| (./images/poznamka.svg) | Při vyplňování formuláře je nutné pro více jazykové aplikace uvést názvy v podporovaných jazycích (cs:NázevAplikace; en:ApplicationName). |




# 2. krok: Instalace a aktivace pokladní aplikace Dotykačka

Prostřednictvím [Dotylačka Marketplace](instalaceaplikaci.md) si do svého zařízení stáhněte a nainstalujte aplikaci Dotykačka. Po její prvním spuštění bude nutné projít [aktivací](aktivace.md). Při aktivaci použijte přidělený testovací klíč. Po úspěšné aktivaci dojde k vytvoření testovacího cloudového úložiště ([Vzdálené správy](vzdalenasprava.md)) a budete moci pokladní aplikaci včetně cloudu začít používat



# 3. krok: Seznámení s možnostmi rozhraní API v2

Nyní se podívejte do dokumentace k rozhraní API a projděte si především [část Obecné](https://docs.api.dotypos.com/api-reference/general) (v anglickém jazyce), abyste porozuměli základním pojmům, dostupným společným funkcím a popisům schémat. Jednotlivé funkce API jsou seskupeny podle entit, které spravují. Pokud hledáte konkrétní funkci z dřívějšího rozhraní API v1, najdete je v části [Služby API v1](https://docs.api.dotypos.com/api-v1-services) (v anglickém jazyce).

| | |
|------|------|
| (./images/tip.svg) | Pro snadnější implementaci je k dispozici [kolekce pro Postman](https://public-docs-data.s3-eu-west-1.amazonaws.com/api/postman/Dotypos+API+v2.postman_collection.json) (v anglickém jazyce), kterou postupně doplňujeme. Pokud hledáte knihovnu pro snadnější integraci API v2, podívejte se do sekce [Knihovny třetích stran](https://docs.api.dotypos.com/others/third-party-libraries) (v anglickém jazyce). |




# 4. krok: Autorizace

Přidělené `Client ID` a `Client Secret` použijete pro připojení klientské aplikace do vašeho testovacího a později zákaznického cloudu. Jde o citlivé osobní údaje, které nikomu nesdělujte. Tyto údaje jsou nutné pro získání autorizačního (`refresh`) tokenu, kterým se vaše aplikace bude připojovat. Pro každé volání API pak budete potřebovat ještě přístupový (`access`) token. Pro další postup se již podívejte do [kompletní dokumentace API v2](https://docs.api.dotypos.com/authorization) v anglickém jazyce), kde je to vše popsáno.

nahoru