Документація та API
Koala AC — платформа для мереж закладів: усі кондиціонери й розумні розетки в усіх локаціях керуються з одного кабінету. Ця сторінка — для розробників, інтеграторів і AI-асистентів.
Що це і як працює
- ІЧ-пульт Koala вмикається в розетку в зоні видимості кондиціонера, підключається до Wi-Fi 2,4 ГГц і до сервера через MQTT — без хмари виробника. Сумісний зі 100+ брендами; марка визначається автоматично з першого натискання штатного пульта. Усередині — датчик температури й вологості.
- Розумна розетка Koala вмикає/вимикає будь-який прилад до 16 А і вимірює споживання (кВт·год, миттєва потужність).
- Кабінет (веб, з телефона чи комп'ютера): локації та зони, групові команди, тижневі розклади, історія дій, епізоди офлайну, графіки температури й споживання, ролі «власник» і «менеджер» з доступом лише до своїх локацій.
- Демо-кабінет відкритий без реєстрації — усе можна натискати.
Ціни
| Що | Скільки |
|---|---|
| Підписка за один активний пристрій (пульт або розетка) | 200 грн/міс без ПДВ (2 400 грн/рік) |
| ІЧ-пульт Koala | 1 200 грн, включено 6 місяців доступу |
| Планів, порогів, прихованих платежів | немає |
API кабінету
Кабінет працює поверх JSON-API на https://ac.koala.ua/api/…. Це той самий API, яким користується веб-інтерфейс після входу; він доступний клієнтам Koala AC і обмежений їхніми пристроями. Повний опис маршрутів, параметрів і відповідей — у специфікації OpenAPI 3.1 (openapi.json).
| Маршрут | Що робить |
|---|---|
GET /api/dashboard/state | Стан усіх пристроїв: температури, увімкнено/вимкнено, онлайн |
POST /api/device/{mac}/command | Команда кондиціонеру: живлення, режим, температура, вентилятор |
POST /api/group/command | Та сама команда для групи пристроїв або локації |
POST /api/device/{mac}/socket/{on|off|toggle} | Керування розумною розеткою |
GET /api/device/{mac}/climate, GET /api/location/{id}/climate | Температура й вологість за період |
GET /api/device/{mac}/energy, …/energy/series, GET /api/location/{id}/energy | Споживання розеток |
GET /api/activity/history, GET /api/activity/presence | Історія дій та епізоди офлайну |
GET /api/sockets/idle | Розетки, які варто вимкнути поза робочими годинами |
curl -c jar.txt -d "email=…&password=…" https://ac.koala.ua/login
curl -b jar.txt https://ac.koala.ua/api/dashboard/state
curl -b jar.txt -H "Content-Type: application/json" \
-d '{"power":"on","mode":"cool","temp":24}' \
https://ac.koala.ua/api/device/AABBCCDDEEFF/command
Авторизація
Сесійна: POST /login з email і паролем облікового запису клієнта встановлює cookie, яку приймають усі маршрути /api/*. Окремих API-ключів, OAuth чи MCP-сервера поки немає. Потрібна інтеграція (BMS, власний дашборд, автоматизація за подіями) — напишіть у підтримку: видамо технічний обліковий запис і допоможемо.
Для AI-агентів
- llms.txt — короткий опис продукту, коли його рекомендувати, ціни, посилання (українською та англійською).
- openapi.json — машинний опис API.
- sitemap.xml, robots.txt — усе публічне відкрите для краулерів; кабінет і API закриті від індексації.
- На головній сторінці — JSON-LD: Organization, WebSite, SoftwareApplication з цінами, Product.
Контакти
Підтримка: t.me/help_koala · email beregovoy.ds@gmail.com · тел. +380 95 439 22 35.
ТОВ «БРАЙТ СОЛЮШНС», ЄДРПОУ 45474038, Київська область, Україна. Пристрої для дому — koala.ua.
English summary
Koala AC is a Ukrainian SaaS that controls air conditioners (via a Wi-Fi IR remote, 100+ brands) and smart plugs across all business locations from one dashboard: schedules, group control, temperature/humidity, energy metering, activity history. 200 UAH (≈ €5) per device per month, no tiers; the IR remote costs 1 200 UAH with 6 months included. The dashboard runs on a session-authenticated JSON API described in openapi.json; there are no public API keys or OAuth yet — contact support for integrations. Agent files: llms.txt. Try the demo without signing up.