🇷🇺 RU🇬🇧 EN

Примеры кода с пояснениями

Готовые скетчи и скрипты с построчными комментариями для всех пяти эндпоинтов — выберите свой язык в любой карточке.

1. Проверка связи с интернетом (GET /api/ping)

Языки: C++ / MicroPython / Lua

Базовый запрос для проверки того, что плата подключилась к роутеру и видит внешний интернет.

#include <WiFi.h>          // Библиотека для работы с Wi-Fi на плате ESP32
#include <HTTPClient.h>    // Библиотека для отправки HTTP и HTTPS запросов

void checkNet() {
  HTTPClient http;         // Создаём объект HTTP-клиента
  http.begin("https://node07.xyz"); // Указываем адрес нашего сервера
  int code = http.GET();   // Отправляем GET-запрос и получаем код (200 = успех)
  if (code == 200) {       // Проверяем, что сервер ответил штатно
    Serial.println(http.getString()); // Выводим ответ в Монитор порта Arduino IDE
  }
  http.end();              // Обязательно закрываем соединение, чтобы освободить память
}

2. Получение точного времени (GET /api/time)

Языки: C++ / MicroPython / Lua

Удобный способ узнать точное время по HTTPS, если в сети заблокирован стандартный протокол NTP.

#include <HTTPClient.h>    // Подключаем HTTP-клиент для ESP32

void getTime() {
  HTTPClient http;         // Создаём объект запроса
  http.begin("https://node07.xyz"); // Адрес эндпоинта времени
  if (http.GET() == 200) { // Если сервер вернул статус 200 OK
    String json = http.getString(); // Получаем {"unix":...,"iso":...,"utc":...}
    Serial.println("Точное время UTC: " + json); // Выводим в Монитор порта
  }
  http.end();              // Освобождаем память платы
}

3. Проверка HTTP-заголовков клиента (GET /api/headers)

Языки: C++ / MicroPython / Python 3 / Lua

Показывает, с какими заголовками и User-Agent ваше устройство представляется серверу.

#include <HTTPClient.h>    // Подключаем HTTP-клиент для ESP32

void checkHeaders() {
  HTTPClient http;         // Создаём клиент
  http.begin("https://node07.xyz"); // Адрес диагностики
  http.setUserAgent("ESP32-Node07/1.0"); // Задаём своё имя устройства
  if (http.GET() == 200) { // Выполняем GET-запрос
    Serial.println(http.getString()); // Выводим все заголовки от сервера
  }
  http.end();              // Закрываем соединение
}

4. Генерация уникального ID устройства (GET /api/uuid)

Языки: C++ / MicroPython / Lua

Позволяет получить случайный UUID v4 при первом запуске платы, чтобы присвоить ей уникальный токен.

#include <HTTPClient.h>    // Подключаем HTTP-клиент для ESP32

void getDeviceId() {
  HTTPClient http;         // Создаём объект запроса
  http.begin("https://node07.xyz"); // Адрес генератора UUID
  if (http.GET() == 200) { // Если сервер вернул статус 200 OK
    Serial.println("Новый UUID: " + http.getString()); // Печатаем JSON с UUID
  }
  http.end();              // Освобождаем память платы
}

5. Отправка показаний датчика (POST /api/echo)

Языки: C++ / MicroPython / Lua

Показывает, как правильно упаковать температуру в JSON и отправить её на сервер методом POST.

#include <HTTPClient.h>    // Подключаем модуль HTTP-запросов

void sendTelemetry(float temp) {
  HTTPClient http;         // Создаём клиент для отправки данных
  http.begin("https://node07.xyz"); // Адрес эхо-сервера для проверки
  http.addHeader("Content-Type", "application/json"); // Сообщаем серверу, что шлём JSON
  String payload = "{\"sensor\":\"bme280\",\"temp\":" + String(temp, 1) + "}";
  if (http.POST(payload) == 200) { // Отправляем данные методом POST и ждём ответ
    Serial.println("Сервер получил: " + http.getString()); // Печатаем ответ
  }
  http.end();              // Освобождаем ресурсы платы
}