Pro využití API s konkrétním obchodníkem je nejprve nutné získat od obchodníka povolení.
Toho se docílí přesměrováním obchodníka na Reservanto s konkrétními parametry.
Adresa po přesměrování: https://testweb.api.reservanto.cz/v1/Authorize/GetLongTimeToken
| Název parametru | Příklad hodnoty | Popis |
|---|---|---|
| clientId | 77843313-03BD-421D-9BFA-A2BB8E2EBF3E | Unikátní identifikátor získaný při registraci klienta. |
| redirectUrl | http://www.klient.com/Callback | Konkrétní adresa pro přesměrování po potvrzení práv obchodníkem. |
| rights | Customer_r | Pole oprávnění, o která klient žádá. Jedná se o pole, takže znásobením tohoto parametru se přidávají další hodnoty. Viz další řádek. |
| rights | Event_r | Další oprávnění, které klient žádá. |
Všechny parametry jsou povinné.
Tyto parametry se posílají metodou GET.
Výsledná URL adresa pro přesměrování potom může vypadat například takto:
Po přesměrování na stranu rezervačního systému Reservanto se obchodník buď nejprve přihlásí, nebo je mu rovnou zobrazen podobný formulář jako na obrázku níže.
Obchodník přístup buď povolí, nebo zamítne a poté dojde k přesměrování zpět na klienta a jeho zadanou redirectUrl (pokud je zaregistrována).
V případě, že obchodník přístup zamítl, dojde k přesměrování s parametry v tomto tvaru:
http://www.klient.com/Callback?accepted=0&token=
Parametr accepted je nastaven na hodnotu 0 a parametr token nemá hodnotu.
V případě, že obchodník přístup povolil, dojde k přesměrování s těmito parametry:
http://www.klient.com/Callback?accepted=1&token=68123711-026d-4ae4-8f9d-405a9de544d1
Parametr accepted je nastaven na hodnotu 1 a parametr token má nastavenou hodnotu.
Navrácená hodnota parametru token je takzvaný LongTimeToken (dále jen LTT) a ten je nutné si pro konkrétního uživatele uložit. Bude potřeba při další komunikaci.