API Enterno.io

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

Все запросы API v3 требуют ключ. Передайте его через заголовок X-API-Key (рекомендуется) или параметр api_key. Поддерживается также JSON body.

Получите API-ключ, зарегистрировав аккаунт или в личном кабинете.

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/check.php?url=example.com"

Каждый ответ содержит заголовок X-Request-Id для отслеживания.

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

API v3 использует JSON:API-стиль с метаданными:

{
  "data": { ... },
  "meta": {
    "request_id": "a1b2c3d4e5f6a7b8c9d0e1f2",
    "duration_ms": 142,
    "cached": false,
    "api_version": "3.0"
  }
}

При ошибке:

{
  "error": {
    "code": "invalid_url",
    "message": "URL обязателен"
  },
  "meta": {
    "request_id": "a1b2c3d4e5f6a7b8c9d0e1f2",
    "duration_ms": 2
  }
}

Для пагинированных эндпоинтов meta включает объект pagination:

"pagination": {
  "total": 15,
  "page": 1,
  "per_page": 25,
  "pages": 1
}

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

Информация о лимитах включена в заголовки ответа:

Области

Каждый API-ключ имеет набор разрешённых областей. Запрос к недоступному эндпоинту вернёт ошибку 403.

Check — Проверка HTTP-заголовков

Получение HTTP-заголовков ответа с детальной разбивкой времени (DNS, подключение, TLS, TTFB).

Параметры

Пример

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/check.php?url=https://example.com"

Ответ

{
  "data": {
    "url": "https://example.com",
    "final_url": "https://example.com/",
    "method": "GET",
    "code": 200,
    "http_version": "HTTP/2",
    "ip": "93.184.216.34",
    "headers": [...],
    "timing": {
      "dns_ms": 12,
      "connect_ms": 45,
      "tls_ms": 78,
      "ttfb_ms": 120,
      "transfer_ms": 142,
      "redirect_ms": 0,
      "redirect_count": 0
    },
    "elapsed_ms": 142
  },
  "meta": {"request_id": "...", "duration_ms": 150, "cached": false, "api_version": "3.0"}
}

DNS — DNS-запрос

Получение DNS-записей с опциональной проверкой DNSSEC.

Параметры

Пример

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/dns.php?domain=example.com&dnssec=1"

SSL — Проверка SSL/TLS

Проверка SSL-сертификата с детальной информацией о цепочке.

Параметры

Пример

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/ssl.php?host=example.com"

IP — Геолокация

Определение местоположения, провайдера и организации по IP-адресу или домену.

Параметры

Пример

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/ip.php?host=8.8.8.8"

Ping — Пинг, порты и трассировка

Пинг хоста, проверка портов или трассировка маршрута.

Параметры

Пример

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/ping.php?host=example.com&action=traceroute"

Health — Оценка здоровья сайта

Комплексный анализ здоровья сайта: заголовки безопасности (30 баллов), SSL/TLS (25 баллов), производительность (25 баллов), лучшие практики (20 баллов). Возвращает оценку 0-100 с грейдом от A+ до F.

Параметры

Пример

curl -H "X-API-Key: YOUR_KEY" \
  "https://enterno.io/api/v3/health.php?url=example.com"

Ответ

{
  "data": {
    "url": "https://example.com",
    "score": 82,
    "grade": "A",
    "categories": [
      {"name": "Security Headers", "score": 22, "max": 30, "checks": [...]},
      {"name": "SSL/TLS", "score": 25, "max": 25, "checks": [...]},
      {"name": "Performance", "score": 20, "max": 25, "checks": [...]},
      {"name": "Best Practices", "score": 15, "max": 20, "checks": [...]}
    ],
    "recommendations": [
      {"type": "critical", "check": "Permissions-Policy"},
      {"type": "warning", "check": "Server info hidden"}
    ]
  },
  "meta": {"request_id": "...", "duration_ms": 2400, "cached": false, "api_version": "3.0"}
}

Monitors — CRUD

Создание, чтение, обновление и удаление мониторов аптайма через API.

Список мониторов

Получить монитор

Возвращает детали монитора с 20 последними проверками.

Создать монитор

curl -X POST "https://enterno.io/api/v3/monitors.php" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "check_type": "http",
    "interval_minutes": 5,
    "expected_code": 200,
    "notify_email": true
  }'

Обновить монитор

curl -X PUT "https://enterno.io/api/v3/monitors.php?id=5" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"interval_minutes": 10, "is_active": false}'

Удалить монитор

curl -X DELETE "https://enterno.io/api/v3/monitors.php?id=5" \
  -H "X-API-Key: YOUR_KEY"

Status — Публичная страница статуса

Получение данных страницы статуса в JSON. Аутентификация не требуется при указании slug.

Пример

curl "https://enterno.io/api/v3/status.php?slug=my-company"

Ответ

{
  "data": {
    "title": "My Company Status",
    "slug": "my-company",
    "overall_status": "operational",
    "monitors_total": 5,
    "monitors_down": 0,
    "monitors": [
      {"id": 1, "name": "example.com", "status": "up", "response_time_ms": 120}
    ],
    "recent_incidents": []
  },
  "meta": {"request_id": "...", "duration_ms": 15, "cached": false, "api_version": "3.0"}
}

Коды ошибок

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

Все запросы к API требуют ключ. Передайте его через заголовок X-API-Key (рекомендуется) или параметр api_key.

Получите API-ключ, зарегистрировав аккаунт или в личном кабинете.

curl -H "X-API-Key: YOUR_KEY" \
  https://enterno.io/api/check.php?url=example.com

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

Все ответы имеют единый формат JSON:

{
  "success": true,
  "data": { ... }
}

При ошибке:

{
  "success": false,
  "error": "Описание ошибки"
}

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

Области

Каждый API-ключ имеет набор разрешённых областей. Запрос к недоступному эндпоинту вернёт ошибку 403.

Эндпоинты

Эндпоинты API v2 используют пути /api/v2/*.php. Все принимают GET и POST.

Коды ошибок