PHPackages                             nchts/ssduu-api-client - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. nchts/ssduu-api-client

ActiveProject[API Development](/categories/api)

nchts/ssduu-api-client
======================

API Системы сбора данных с узлов учёта

v1.0(6y ago)15[2 PRs](https://github.com/nchts/ssduu-api-client/pulls)MITPHPPHP ^7.1.3

Since Jul 31Pushed 3y agoCompare

[ Source](https://github.com/nchts/ssduu-api-client)[ Packagist](https://packagist.org/packages/nchts/ssduu-api-client)[ RSS](/packages/nchts-ssduu-api-client/feed)WikiDiscussions master Synced 3d ago

READMEChangelog (1)Dependencies (1)Versions (4)Used By (0)

API Системы сбора данных с узлов учёта
======================================

[](#api-системы-сбора-данных-с-узлов-учёта)

Общие сведения
--------------

[](#общие-сведения)

Версия протокола: 1.0 Источник данных:

Сначала выполняется аутентификация через POST запрос с передачей имени пользователя и пароля. После положительного ответа необходимо использовать возвращённый Токен во всех остальных запросах. Эти запросы должны выполняться через заголовок Bearer методом POST. Все ответы возвращаются в формате JSON. Подробнее об HTTP Bearer авторизации можно прочитать здесь: Простое описание протокола Bearer заключается во включении в заголовки запроса следующей строки:

**Authorization: Bearer {TOKEN}**

Например:

**Authorization: Bearer mFc9dB5f-4.1JqM**

Установка тестового примера
---------------------------

[](#установка-тестового-примера)

composer create-project nchts/ssduu-api-client

Запуск :

**php run.php**

Аутентификация через API
------------------------

[](#аутентификация-через-api)

Формат POST запроса: **/user/login?username={username}&amp;password={password}**

Если учётная запись принята, то в качестве вернётся AccessToken, который необходимо использовать во всех остальных запросах.

Пример ответа:

`[{"access_token": "LKdVAB7_1XDiWhNjnoJvZOFNI7dbutb"}]`

Информация об узлах учёта
-------------------------

[](#информация-об-узлах-учёта)

Параметры возвращаемого объекта:

ПараметрОписаниеТипФорматidКлючЦелое числоIntidentifierИдентификаторСтроковыйVarchar(70)addressАдресСтроковыйVarchar(100)address\_fullАдресСтроковыйVarchar(300)device\_typeТип прибораСтроковыйVarchar(50)serialНомер прибораЦелое числоBigintconsumerПотребительСтроковыйVarchar(150)commercialКоммерческийБулевоBoollast\_archive\_dayМаксимальная дата суточного архиваСтроковыйДД.ММ.ГГГГ ЧЧ:ММ:ССФорматы представлены в типах базы данных, в скобках указана длина.

**Пример использования:**

Запрос списка всех узлов учёта: **/device/list**

Часть ответа, который представляет собой массив с объектами:

`[{"id":"102770","address":" \"Лицей-интернат №79\" (д.48/19)","address_full":"Ул. Татарстан,31","identifier":"4801901","serial":"901490","commercial":true,"company_name":"Управление образования","device_type":"ТСРВ-024М", ”last_archive_day”:”23.07.2019 23:00:00”}, {"id":"102865","address":" \"Средняя школа №33\" (д.25/22)","address_full":"г.Набережные Челны . ул.Татарстан, д 14","identifier":"2502201","serial":"902750","commercial":true,"company_name":"Управление образования","device_type":"ТСРВ-024М", ”last_archive_day”:”23.07.2019 23:00:00”}, … ]`

Получение начала и окончания архива
-----------------------------------

[](#получение-начала-и-окончания-архива)

Может быть необходимо при первоначальной загрузке данных. Формат запроса: **/archive/range?id={id}**

Пример ответа:

`[{"start": "01.06.2010", "end": "23.07.2019"}]`

Архивы теплосистемы c холодной водой
------------------------------------

[](#архивы-теплосистемы-c-холодной-водой)

Количество запрашиваемых архивов ограничено 200 записями за один запрос.

Параметры возвращаемого объекта:

ПараметрОписаниеТипФорматtimeВремяСтроковыйДД.ММ.ГГГГhoursНаработкаТочное числоDouble(10,2)\*v5Объем в подающем трубопроводеТочное числоDouble(15,3)\*v6Объем в обратном трубопроводеТочное числоDouble(15,3)\*t5Температура в подающем трубопроводеТочное числоDouble(10,2)\*t6Температура в обратном трубопроводеТочное числоDouble(10,2)\*p5Давление в подающем трубопроводеТочное числоDouble(10,2)\*p6Давление в обратном трубопроводеТочное числоDouble(10,2)\*Формат\* - где число до запятой – общее число знаков, а после запятой – точность дробной части. Например, time = 01.07.2019; hours = 23,59; v5 = 12,371; t5 = 16,32; p5 = 6.32.

Формат запроса:

***/archive/read-cold-water?id={id}&amp; start={start}&amp; end={end}***

Где:

- {id} – Ключ узла учёта;
- {start} - Начала периода в формате ДД.ММ.ГГГГ;
- {end} - Окончание периода в формате ДД.ММ.ГГГГ. Если данный параметр не будет указан, то выборка будет производится по максимальному количеству строк для запроса – 200 строк.

**Пример использования:**

Запрос: **/archive/read-cold-water?id=100644&amp;start=01.07.2019&amp;end=23.07.2019**

Ответ в формате JSON, массив с объектами:

```
[
	{"time":"26.07.2019","hours":24,"v5":18.789,"v6":0,"t5":0,"t6":0,"p5":8.16, "p6":3.57},
	{"time":"27.07.2019","hours":24,"v5":17.543,"v6":0,"t5":0,"t6":0,"p5":8.16, "p6":3.57},
	{"time":"28.07.2019","hours":24,"v5":19.459,"v6":0,"t5":0,"t6":0,"p5":8.16, "p6":3.57}
]

```

Дата обновления документации: 29.07.2019

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity5

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity56

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2479d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/2b4379f0e7bd24048c19a8b1ccf8e1e0c28d691ab8a0685c62a38d07e648be37?d=identicon)[nchts](/maintainers/nchts)

### Embed Badge

![Health badge](/badges/nchts-ssduu-api-client/health.svg)

```
[![Health](https://phpackages.com/badges/nchts-ssduu-api-client/health.svg)](https://phpackages.com/packages/nchts-ssduu-api-client)
```

###  Alternatives

[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)[convertkit/convertkitapi

Kit PHP SDK for the Kit API

2167.1k1](/packages/convertkit-convertkitapi)[mapado/rest-client-sdk

Rest Client SDK for hydra API

1125.9k2](/packages/mapado-rest-client-sdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
