CONTROL SCHEMA · EXAMPLESСХЕМА УПРАВЛЕНИЯ · ПРИМЕРЫ

The smart home.
On a protocol.
Умный дом.
На протоколе.

Every action in a smart home starts with a small request. Below are sample calls and replies. No server is connected.Каждое действие в умном доме начинается с небольшого запроса. Ниже — примеры вызовов и ответов. Сервер не подключён.

See how it worksКак это устроено
EXAMPLESПРИМЕРЫ
Base URLБаза запросовhttps://home-i.ru/api/v1
AuthorizationАвторизацияBearer home_i_demo_••••
home-i · v1

GET /homes/demo/state

RequestЗапрос

GET /api/v1/homes/demo/state HTTP/1.1
Host: home-i.ru
Authorization: Bearer home_i_demo_••••
GET /homes/demo/state

ResponseОтвет

{
  "home": "demo",
  "scene": "morning",
  "temperature_c": 22,
  "lights_pct": 85,
  "curtains": "open",
  "presence": "home",
  "updated_at": "2026-10-24T08:05:00Z"
}
200 OKapplication/json

PATCH /homes/demo/state

RequestЗапрос

PATCH /api/v1/homes/demo/state HTTP/1.1
Host: home-i.ru
Content-Type: application/json
Authorization: Bearer home_i_demo_••••

{
  "temperature_c": 23,
  "lights_pct": 45,
  "curtains": "closed"
}
PATCH /homes/demo/state

ResponseОтвет

{
  "home": "demo",
  "applied": {
    "temperature_c": 23,
    "lights_pct": 45,
    "curtains": "closed"
  },
  "scene": "custom",
  "updated_at": "2026-10-24T20:12:00Z"
}
200 OKapplication/json

POST /homes/demo/scenes

RequestЗапрос

POST /api/v1/homes/demo/scenes HTTP/1.1
Host: home-i.ru
Content-Type: application/json
Authorization: Bearer home_i_demo_••••

{
  "scene": "evening"
}
POST /homes/demo/scenes

ResponseОтвет

{
  "home": "demo",
  "scene": "evening",
  "temperature_c": 23,
  "lights_pct": 45,
  "curtains": "closed"
}
201 Createdapplication/json

GET /homes/demo/events?limit=3

RequestЗапрос

GET /api/v1/homes/demo/events?limit=3 HTTP/1.1
Host: home-i.ru
Authorization: Bearer home_i_demo_••••
GET /homes/demo/events?limit=3

ResponseОтвет

{
  "home": "demo",
  "events": [
    {
      "type": "scene",
      "scene": "morning",
      "at": "2026-10-24T08:00:00Z"
    },
    {
      "type": "comfort",
      "temperature_c": 22,
      "lights_pct": 85,
      "at": "2026-10-24T08:05:00Z"
    }
  ]
}
200 OKapplication/json

POST /homes/demo/integrations

RequestЗапрос

POST /api/v1/homes/demo/integrations HTTP/1.1
Host: home-i.ru
Content-Type: application/json
Authorization: Bearer home_i_demo_••••

{
  "ecosystem": "aqara",
  "connection": "zigbee",
  "controller": "home-assistant"
}
POST /homes/demo/integrations

ResponseОтвет

{
  "integration": "home-demo-aqara",
  "home": "demo",
  "ecosystem": "aqara",
  "connection": "zigbee",
  "status": "connected",
  "devices": 6
}
201 Createdapplication/json