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

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

Добро пожаловать в документацию API NETTS. Наш API предоставляет программный доступ к сервисам NETTS, позволяя интегрировать функциональность аренды и управления энергией в ваши собственные приложения.

# Обзор

NETTS предлагает RESTful API, который взаимодействует по протоколу HTTPS и возвращает ответы в формате JSON. Все запросы требуют аутентификации с использованием API-ключа.

Наш API позволяет:

  • Проверять текущие цены на энергию
  • Получать информацию о вашем аккаунте
  • Получать доступ к истории делегирования
  • Просматривать баланс и статистику использования

# Базовый URL

Все конечные точки API используют следующий базовый URL:

https://netts.io/apiv2/

# Доступные эндпоинты

Эндпоинт Описание
/prices Получение текущих цен на энергию для разных периодов времени
/userinfo Получение информации об аккаунте и статистики

# Ограничения частоты запросов

Для обеспечения справедливого использования и стабильности системы в API действуют ограничения частоты запросов. В настоящее время лимит составляет 2 запроса в секунду на один API-ключ.

Если вы превысите этот лимит, API вернет код состояния 429 Too Many Requests.

# Формат ответа

Все ответы API представлены в формате JSON и включают поле status, которое указывает, был ли запрос успешным или нет.

# Пример успешного ответа

{
  "status": "success",
  "timestamp": "2025-04-23 12:34:56",
  "data": {
    // Данные ответа
  }
}

# Пример ответа с ошибкой

{
  "status": "error",
  "code": 401,
  "message": "Invalid API key or IP not in whitelist"
}

# Начало работы

  1. Получите API-ключ
  2. Аутентифицируйте ваши запросы
  3. Изучите наши эндпоинты API
  4. Ознакомьтесь с нашими примерами кода, чтобы быстро начать работу

← Аутентификация →