🇷🇺 RU🇬🇧 EN

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

Базовый URL: https://api.node07.xyz • Формат: application/json; charset=utf-8 • Лимит POST: 8 КБ • Частота: 15 req/s

GET/api/ping

Проверка доступности интернета и времени работы узла. Минимальный размер ответа позволяет парсить его без выделения больших буферов в RAM.

Пример запроса и ответа
$ curl -s https://api.node07.xyz/api/ping
{"status":"ok","message":"pong","node":"node07","uptime_sec":3600,"requests":42191}
ПолеТипОписание
statusstringСостояние узла (всегда "ok" при штатной работе)
messagestringКонтрольный ответ "pong"
uptime_secintВремя непрерывной работы сервера в секундах

  
GET/api/time

Получение точного времени по HTTP/HTTPS для синхронизации внутренних часов (RTC) контроллера в сетях, где заблокирован UDP-порт 123 (NTP).

Пример запроса и ответа
$ curl -s https://api.node07.xyz/api/time
{"unix":1794808000,"iso":"2026-11-16T05:46:40+00:00","utc":"2026-11-16 05:46:40"}
ПолеТипОписание
unixintСекунды с 1 января 1970 года (UTC)
isostringДата и время в стандарте ISO-8601
utcstringЧитаемая строка времени в часовом поясе UTC

  
GET/api/headers

Возвращает HTTP-заголовки, с которыми запрос от контроллера дошёл до сервера. Помогает отлаживать User-Agent, токены авторизации и прокси.

Пример запроса и ответа
$ curl -s https://api.node07.xyz/api/headers
{"headers":{"host":"api.node07.xyz","user-agent":"ESP32HTTPClient"},"protocol":"HTTP/1.1"}
ПолеТипОписание
headersobjectСловарь всех входящих HTTP-заголовков в нижнем регистре
protocolstringВерсия HTTP-протокола клиента

  
GET/api/uuid

Генерация случайного уникального идентификатора UUID v4. Удобно для присвоения уникального ID прошивкам без аппаратного генератора случайных чисел.

Пример запроса и ответа
$ curl -s https://api.node07.xyz
{"uuid":"550e8400-e29b-41d4-a716-446655440000"}
ПолеТипОписание
uuidstringСлучайный 128-битный идентификатор в формате UUID v4

  
POST/api/echo

Эхо-эндпоинт для проверки отправки JSON-телеметрии с прошивки. Принимает тело до 8192 байт и возвращает его обратно с меткой времени.

Пример запроса и ответа
$ curl -s -X POST https://api.node07.xyz/api/echo -H "Content-Type: application/json" -d '{"temp":23.5}'
{"received":{"temp":23.5},"timestamp":1794808000}
ПолеТипОписание
receivedanyРаспарсенный JSON-объект из тела запроса (или строка raw)
timestampintUnix-время приёма пакета сервером

  

Коды ответов HTTP

КодСтатусПричина
200OKЗапрос успешно обработан
400Bad RequestНекорректный заголовок Content-Length
404Not FoundНеизвестный маршрут API
413Payload Too LargeТело POST-запроса превышает лимит 8 КБ
429Too Many RequestsПревышен лимит частоты запросов (15 req/s)

Примеры отрицательных ответов

При ошибках уровня приложения API возвращает JSON с ключом error. При срабатывании защиты веб-сервера (429) возвращается стандартный ответ Nginx.

404 Not Found — запрос к несуществующему пути
{"error": "not found"}
413 Payload Too Large — тело POST-запроса больше 8192 байт
{"error": "payload too large"}
400 Bad Request — некорректный заголовок Content-Length
{"error": "bad length"}
429 Too Many Requests — превышен лимит 15 req/s (ответ Nginx)
<html><head><title>429 Too Many Requests</title></head>...