Документация API

GET /api/vdkanal

Авторизация и получение данных Водоканала

Параметры (GET):

• login — номер лицевого счета
• password — пароль

{
  "counters": [
    {
      "id": XXXXXXXXX,
      "name": "Счетчик СГВ-15",
      "previous_value": "2",
      "date": "09.02.2026",
      "type": "hot-counter"
    },
    ...
  ],
  "cookie": "_csrf-natural=...",
  "csrfToken": "CTX...==",
  "account": XXXXXX
}

POST /api/vdkanal

Передача показаний счетчика в Водоканал

Параметры (JSON в теле запроса):

• account — номер лицевого счета
• csrfToken — CSRF-токен, полученный из GET /api/vdkanal
• cookie — cookie, полученный из GET /api/vdkanal
• counter — ID счетчика (device-id)
• value — передаваемое значение показаний

Пример запроса:

POST /api/vdkanal
Content-Type: application/json

{
  "account": "XXXXXXXXX",
  "csrfToken": "CTX...==",
  "cookie": "_csrf-natural=...; PHPSESSID=...",
  "counter": "YYYYYYYYY",
  "value": "10"
}

Форма-песочница для тестирования POST /api/vdkanal

Вы можете протестировать запрос прямо здесь. Все данные отправляются на этот сервер, который затем пересылает их в Водоканал.

account (лицевой счет):

csrfToken:

cookie:

counter (device-id):

value (показания):

Отправить POST /api/vdkanal

Ответ сервера:

// Ответ будет показан здесь

GET /api/esplus

Авторизация в Энергосбыте и получение списка счетчиков

Параметры (GET):

• login — логин для авторизации
• password — пароль для авторизации

Сервер авторизуется во внутреннем API Энергосбыта и возвращает удобный JSON:

{
  "counters": [
    {
      "id": "123456",
      "number": "2255",
      "unit": "Куб.м",
      "type": "Счетчик расхода воды",
      "digits": "3",
      "installed_date": "01.12.2019",
      "verification_period": "24.07.2022",
      "service": {
        "id": "123456",
        "code": "heat_energy",
        "name": "Тепл.эн.на нужды ГВС"
      },
      "accepted": {
        "date": "31.01.2026",
        "period": "Январь 2026",
        "t1": 220.45,
        "t1_formatted": "220,45"
      }
    },
    ...
  ],
  "accessToken": "eyJ0eXA...JK9e6JDrp-Y",
  "account": "KIESB%7CXXXXXX"
}

POST /api/esplus

Передача показаний счетчика в Энергосбыт

Параметры (JSON в теле запроса):

• token — Bearer-токен Энергосбыта (полученный из GET /api/esplus)
• account — account_id, например KIESB%7C6451093100
• counter — meter_id счетчика
• value — числовое значение показаний (отправляется в поле t1)

Пример запроса:

POST /api/esplus
Content-Type: application/json

{
  "token": "eyJ0eXA...JK9e6JDrp-Y",
  "account": "KIESB%7CXXXXXXXXX",
  "counter": "YYYYYYYYYY",
  "value": 123.45
}

Форма-песочница для тестирования POST /api/esplus

Сначала вызовите GET /api/esplus, получите accessToken и нужный meter_id, затем подставьте их сюда.

token (Bearer):

account (account_id):

counter (meter_id):

value (t1, показания):

Отправить POST /api/esplus

Ответ сервера:

// Ответ будет показан здесь