¶ Referenční příručka API - Přihlášení
¶ Autentizace
¶ Podporované metody
- Basic authentication - uživatelské jméno a heslo přenášené v každém volání
- JWT Bearer Token - token vygenerovaný jednorázově, použitý v hlavičce dalších volání
Obě metody vyžadují dedikovaný API uživatelský účet s rolí „API přístup".
¶ Vytvoření API účtu
- Přejděte do sekce Administrace
- Zvolte Nový uživatel
- Zadejte uživatelské jméno nového API účtu (příklad:
api@vasedomena.com) - Jméno a příjmení zvolte libovolně (např. „API")
- Vyberte svoji vlastní společnost
- Odeberte příznak „Automaticky vygenerovat heslo" a nastavte vlastní heslo
- Odeberte příznak „Odeslat uvítací email"
- V sekci Uživatelské role vyberte roli „API přístup"
- Odeberte příznak „Emailové notifikace"
- Nového uživatele uložte
¶ Vygenerování JWT tokenu
Pro komunikaci s API je nutné nejprve získat Bearer Token (JWT) voláním:
POST https://api.timeslotcontrol.com/v1/{tenant}/Token
Kde {tenant} je název zákazníka v URL adrese Time Slot Control - například pro https://lotraco.timeslotcontrol.com je tenant lotraco.
Příklad volání (cURL):
curl -X POST "https://api.tscsandbox.com/v1/{tenant}/Token" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-d "{\"username\": \"api@vasedomena.com\", \"password\": \"heslo\"}"
JSON odpověď:
{ "token": "eyJhbGciOi..." }
Získaný token použijte v hlavičce každého dalšího volání:
curl -X GET "https://api.tscsandbox.com/v1/{tenant}/Ping" \
-H "Authorization: Bearer eyJhbGciOi..."
Není nutné generovat nový token pro každé volání - token zůstává platný po omezenou dobu.
Vygenerování tokenu a autentizace v API Reference:
Otevřete API Reference na adrese https://api.tscsandbox.com/ a klikněte v levém menu na Token. Endpoint POST /v1/{tenant}/Token zobrazí formulář pro zadání přihlašovacích údajů.
Získaný token vložte do pravého panelu Authentication → Bearer: header → Value:
Následně je možné volat jakékoliv API endpointy přímo z rozhraní.