API Documentation

Интегрируйте AlertHub в ваши системы безопасности

Получение API ключа

Для доступа к API необходима регистрация. API ключ будет доступен в личном кабинете после верификации.

Быстрый старт

1. Получите API ключ

Зарегистрируйтесь как исполнитель и получите уникальный API ключ в личном кабинете

2. Аутентификация

Используйте Bearer токен в заголовке Authorization для всех запросов

3. Начните интеграцию

Используйте наши endpoints для получения заявок и управления услугами

Base URL

https://alerthub.ru/api/v1/

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

Все запросы к защищенным endpoints требуют заголовок авторизации:

Authorization: Bearer YOUR_API_KEY

Демо токены для тестирования:

  • demo_token_2024 - для тестирования API
  • test_api_key_123 - альтернативный тестовый ключ

Важно: В продакшене используйте уникальные API ключи. Храните их в безопасности.

Публичные endpoints (без авторизации):

  • • GET /api/services.php - список услуг
  • • GET /api/executors.php - список исполнителей
  • • GET /api/contacts.php - контактная информация

Защищенные endpoints (требуют токен):

  • • GET /api/requests.php - заявки для исполнителей
  • • GET /api/profile.php - профиль исполнителя
  • • POST /api/requests.php - отправка предложения
  • • PUT /api/profile.php - обновление профиля

API Endpoints

GET

/services

Получить список услуг

Возвращает список всех доступных услуг кибербезопасности

Response (200 OK):

{
  "success": true,
  "services": [
    {
      "id": "pentest",
      "name": "Тестирование на проникновение",
      "description": "Комплексная проверка безопасности",
      "price_from": 150000,
      "duration": "5-10 дней"
    }
  ]
}
GET

/requests

Получить заявки для исполнителя

Возвращает список заявок, соответствующих профилю исполнителя

Query Parameters:

  • status - Фильтр по статусу (new, in_progress, completed)
  • service - Фильтр по типу услуги
  • limit - Количество результатов (max: 100)
POST

/requests/{id}/bid

Отправить предложение по заявке

Позволяет исполнителю отправить коммерческое предложение

Request Body:

{
  "price": 250000,
  "duration_days": 7,
  "description": "Детальное описание предложения",
  "start_date": "2025-02-01"
}
GET

/profile

Профиль исполнителя

Возвращает информацию о текущем исполнителе

PUT

/profile

Обновить профиль

Обновляет информацию профиля исполнителя

Лимиты запросов

Стандартный план

  • • 1000 запросов в час
  • • 10000 запросов в день
  • • До 10 одновременных соединений

Premium план

  • • 10000 запросов в час
  • • Без дневного лимита
  • • До 100 одновременных соединений

Коды ошибок

200 OK - Запрос выполнен успешно
201 Created - Ресурс успешно создан
400 Bad Request - Неверный формат запроса
401 Unauthorized - Требуется аутентификация
403 Forbidden - Доступ запрещен
404 Not Found - Ресурс не найден
429 Too Many Requests - Превышен лимит запросов
500 Internal Server Error - Внутренняя ошибка сервера

SDK и библиотеки

Python

pip install alerthub-api

Node.js

npm install @alerthub/api

PHP

composer require alerthub/api

Поддержка

Нужна помощь с интеграцией? Мы готовы помочь!

api@alerthub.ru GitHub