SmartKey Konektor

Jednotné API pro ovládání chytrých zámků – dokumentace a podklady pro integraci

Dokumentace pro lidi

📊

API reference – Excel

Kompletní přehled všech příkazů po kategoriích: co dělají, jaké parametry přijímají a co vracejí. Včetně chybových kódů.

Stáhnout XLSX
📄

API reference – Markdown

Stejný obsah jako Excel, v textové podobě vhodné pro vývojáře a verzování.

Otevřít MD
🚀

Průvodce pro začátek

Autentizace, základní principy, příklady prvních requestů.

Otevřít průvodce
🔌

Integrace zařízení Tuya

Ovládání chytrých zařízení Tuya (zásuvky, žaluzie, senzory, BLE zámky) přes stejný konektor: založení projektu, propojení mobilní aplikace, seznam zařízení, stav a ovládání.

Otevřít návod Tuya
🏡

Integrace Home Assistant

Ovládání entit Home Assistantu (zámky, spínače, světla, rolety) přes stejný konektor: token, stavy entit, volání služeb.

Otevřít návod Home Assistant
🏠

Integrace Loxone

Ovládání Loxone Miniserveru přes stejný konektor: struktura, příkazy ovládacím prvkům.

🔧 Konektor připravujeme
🪟

Integrace Somfy

Ovládání zařízení Somfy (rolety, žaluzie, markýzy) přes TaHoma Developer Mode: aktivace, adresa boxu a token, zařízení, příkazy.

Otevřít návod Somfy

Podklady pro AI a nástroje

🤖

Kontext pro AI asistenty

Jeden soubor, který vložíte do AI (ChatGPT, Claude, Copilot…) a ta se naučí kompletně pracovat s konektorem – všechny příkazy, pravidla, ukázky kódu i typické scénáře. Ideální když chcete, aby vám AI napsala integraci do vašeho systému.

Stáhnout llms-full.txt
⚙️

OpenAPI 3.0 specifikace

Strojově čitelný popis celého API. Naimportujete do Postmanu, Swaggeru, generátorů klientů (openapi-generator) nebo dáte AI agentovi jako definici nástrojů.

Stáhnout openapi.json
Adresa API: https://connect.smartkey.cz. Přístupové údaje (client_id a client_secret) posílejte v hlavičkách X-Client-Id a X-Client-Secret – přiděluje je SmartKey.