--- title: Přihlášení/odhlášení (iOS) description: "Od verze aplikace **1.15** je možné provést přihlášení a odhlášení z aplikace přímo z vašeho systému pomocí deeplink API. Díky přímému přihlášení/odhlášení přes API se obsluha nemusí přepínat do samostatné GP tom aplikace a ručně zadávat přihlašovací údaje — celý…" url: "https://www.gptom.com/ro/docs/api/ios/prihlaseni-odhlaseni-ios/" updated: "2026-08-18" category: iOS API tags: - ios --- # Přihlášení/odhlášení (iOS) Od verze aplikace **1.15** je možné provést přihlášení a odhlášení z aplikace přímo z vašeho systému pomocí deeplink API. Díky přímému přihlášení/odhlášení přes API se obsluha nemusí přepínat do samostatné GP tom aplikace a ručně zadávat přihlašovací údaje — celý proces nyní můžete řídit ze své vlastní aplikace. To zkracuje dobu potřebnou k aktivaci terminálu, snižuje počet dotazů na podporu ohledně přihlašování a hlavně zjednodušuje situace s častým střídáním obsluhy nebo zařízení (směny v gastru/retailu, kurýři sdílející terminály mezi směnami). **Přihlášení do aplikace** **Request** Cesta deeplinku: gptom://login Parametr username password tid redirectUrl Příklad merchant@example.com silneheslo 123456 gp://login Typ string string string string Povinný ano ano ano ano **Příklad volání** ***gptom://login?*** *username=merchant%40example.com&**password=silneheslo&**tid=123456&**redirectUrl=gp%3A%2F%2Flogin* Pokud se ve stavu **ERROR** vrátí **error=passwordChangeRequired**, jedná se o první přihlášení uživatele a je potřeba projít flow popsané níže. **Prvotní přihlášení do aplikace se změnou hesla** Pokud uživatel ještě nemá nastavené heslo pro deeplink přihlášení (první přihlášení), vrátí login volání chybu passwordChangeRequired. V takovém případě je nutné zaslat deeplink change-password, a to ve dvou krocích.   **Request** Cesta deeplinku: gptom://change-password Parametr username password newPassword tid code redirectUrl Příklad merchant@example.com silneheslo NoveSilneHeslo1 123456 AsfweWW41515 gp://change-password Typ string string string string string string Povinný ano ano ano ano ne (pouze v kroku 2) ano **Krok 1 - bez vyžádání ověřovacího kódu** Volání bez parametru Code. V případě úspěchu (status=COMPLETED, bez erroru) systém odešle ověřovací kód na e-mail uživatele. ***gptom://change-password?*** *username=merchant%40example.com&**password=silneheslo& newPassword=NoveSilneHeslo1&**tid=123456&**redirectURL=gp%3A%2F%2Fchange-password* **Krok 2 - potvrzení kódem** Stejné volání doplněné o parametr **code** zaslaný na e-mail. V případě úspěchu je heslo změněno a lze pokračovat běžným loginem. ***gptom://change-password?*** *username=merchant%40example.com&**password=silneheslo& newPassword=NoveSilneHeslo1&**tid=123456& code=AsfweWW41515&**redirectURL=gp%3A%2F%2Fchange-password* **Odhlášení z aplikace (Logout)** **Request** Cesta deeplinku: gptom://logout Parametr redirectUrl Příklad gp://logout Typ string Povinný ano gp://logout?redirectUrl=gp%3A%2F%2Flogout **Stavové kódy** Kód / Code COMPLETED ERROR CANCELLED Popis / Description CZ: Požadavek byl úspěšně dokončen. EN: Request completed successfully. CZ: Požadavek skončil chybou — podrobnosti viz parametr error. EN: Request failed — see the error parameter for details. CZ: Uživatel požadavek v aplikaci GP tom zrušil (např. zavřel obrazovku). EN: User cancelled the request inside the GP tom app. **Chybové kódy relevantní pro login/logout** Kód / Code invalidCredentials tidNotAssignedToThisUser tidAlreadyOccupied anotherTidUsedOnThisDevice passwordChangeRequired passwordPendingConfirmation invalidCode userNotLoggedIn invalidUserName terminalSetupFailed Popis / Description CZ: Nesprávné uživatelské jméno nebo heslo. EN: Invalid username or password. CZ: Zadané TID není přiřazeno tomuto uživateli. EN: The provided TID is not assigned to this user. CZ: Zadané TID je již obsazeno jiným uživatelem. EN: The provided TID is already occupied by another user. CZ: Na tomto zařízení je stejný uživatel přihlášen k jinému TID. EN: The same user is already logged in on this device with a different TID. CZ: Jde o první přihlášení - je nutné nejprve nastavit heslo. EN: First login - password must be set first. CZ: Nastane při prvním přihlášení po kroku č.1, kdy je zaslán aut. kód na email. EN: This occurs upon the first login following step 1, when an authorization code is sent via email. CZ: Zadaný ověřovací kód pro dokončení změny hesla je neplatný. EN: The provided confirmation code for the password change is invalid. CZ: Uživatele se nepodařilo přihlásit EN: It was not possible to log in user. CZ: Nesprávně zadané přihlašovací údaje. EN: Incorrect credentials sent. CZ: Aktivace terminálu selhala. Obraťte se prosím na naši podporu. EN: Terminal setup has failed. Please contact our support. ## **Ověření stavu přihlášení** Pro zjištění stavu aplikace zda je již uživatel v aplikaci GP tom přihlášen, je možné zavolat metodu **Get status**. Metoda umožňuje získat aktuální informace o stavu aplikace a přihlášeném obchodníkovi. Podrobné informace o použití metody a její implementaci najdete v [iOS dokumentaci k metodě Get status](https://www.gptom.com/docs/api/ios/get-status-metoda-ios/).