Více
    Registrace
    Domů / Články / Chytré kliky a zámky / Jak odemknout TTLock kliku přes API

    Jak odemknout TTLock kliku přes API

    🔓 Jak odemknout chytrou kliku TTLock přes API

    Chytré kliky TTLock můžete ovládat nejen pomocí mobilní aplikace, ale i na dálku přes internet – díky otevřenému API rozhraní. To se hodí například pro správce budov, provozovatele ubytování nebo vývojáře chytré domácnosti.

    V tomto článku vám ve zkratce ukážeme, jak pomocí API kliky TTLock odemykat. 

    (Tento návod slouží pouze jako ilustrační příklad použití TTLock API. Každý uživatel je zodpovědný za správné nastavení, bezpečnost integrace a výběr nástrojů, které používá. Doporučujeme vše nejprve důkladně otestovat a ověřit ve vlastním prostředí.)

    ✅ Co potřebujete

    • Chytrou kliku TTLock s aktivovaným Remote Unlock v aplikaci
    • Vývojářský účet na euopen.ttlock.com
    • Schválenou aplikaci typu Web
    • Nástroj pro odesílání API požadavků – například Postman nebo Hoppscotch 

    🔑 Krok 1 – Získání Access Tokenu

    1. Přihlašte se na TTLock Developer portál a získejte client_id a client_secret.
    2. Převeďte své heslo z TTLock mobilní aplikace na MD5 hash (např. na md5hashgenerator.com).
    3. V nástroji pro odesílání API požadavků odešlete POST požadavek na URL: https://euapi.ttlock.com/oauth2/token
    4. Do těla požadavku (x-www-form-urlencoded) přidejte:
      • client_id, client_secret
      • username (e‑mail z TTLock)
      • password (MD5 hash hesla)
      • grant_type=password
      • redirect_uri=https://www.example.com

    ✔️ V odpovědi obdržíte access_token, který použijete v dalších krocích.

    📋 Krok 2 – Získání lockId zámku

    Odešlete nový POST požadavek na:  https://euapi.ttlock.com/v3/lock/list

    Parametry v těle:

    • clientId
    • accessToken
    • pageNo=1
    • pageSize=10
    • date – aktuální čas v milisekundách (např. z currentmillis.com)

    ✔️ V odpovědi najdete lockId své kliky.

    🔓 Krok 3 – Odemčení kliky

    Pošlete požadavek na: https://euapi.ttlock.com/v3/lock/unlock

    Parametry:

    • clientId
    • accessToken
    • lockId
    • date – aktuální čas v ms

    ✔️ Při úspěchu dostanete odpověď { "errcode": 0, "errmsg": "success" } a klika se otevře.

    💡 Tipy na závěr

    • Hlídejte přesný čas – server toleruje rozdíl max ±5 minut.
    • Token má omezenou platnost – po čase ho je nutné obnovit.
    • V TTLock aplikaci musí být Remote Unlock zapnutý pro každou kliku.

    Potřebujete s napojením pomoci? Ozvěte se nám – rádi poradíme.