Health & Status API

Перевірка доступності API FonProxy і моніторинг часу безвідмовної роботи зовнішніх сервісів за допомогою публічних кінцевих точок здоров'я та статусу.

Updated 2026-04-10 12:12:00
Health & Status API

Для інформації про заголовки автентифікації, API keys і загальний формат помилок перегляньте API General.


Перевірка здоров'я

Публічна кінцева точка — автентифікація не потрібна.

GET /health

Повертає поточний статус API.

Відповідь

{
  "status": "ok"
}

Монітор статусу

Публічні кінцеві точки для перегляду статусу моніторингу сервісів. Автентифікація не потрібна. Обмеження швидкості: 60 req/min на IP (графік: 30 req/min).

Статусні значення: up · down · degraded · unknown


Перелік служб

GET /status

Повертає всі увімкнені моніторинг-сервіси з їх поточним статусом.

Відповідь

{
  "services": [
    {
      "id": "a1b2c3d4e5",
      "publicName": "API Gateway",
      "status": "up",
      "lastCheckedAt": "2026-04-10T11:00:00.000Z"
    }
  ]
}

Загальний підсумок

GET /status/summary

Агреговане здоров'я платформи для всіх моніторинг-сервісів.

Відповідь

{
  "overall": "operational",
  "total": 5,
  "up": 4,
  "down": 0,
  "degraded": 1
}

overall значення: operational · degraded · major_outage


Деталі сервісу

GET /status/:id

Статус окремого сервісу з відсотком безвідмовної роботи за 30 днів.

ПараметрТипОпис
idstringID сервісу

Відповідь

{
  "id": "a1b2c3d4e5",
  "publicName": "API Gateway",
  "status": "up",
  "lastCheckedAt": "2026-04-10T11:00:00.000Z",
  "uptime30d": 99.87
}

Графік сервісу

GET /status/:id/graph

Дані графіку часових рядів. Автоматично вибирає гранулярність залежно від діапазону дат:

ДіапазонГранулярність
≤ 2 днівЩогодини
≤ 14 днівКожні 6 годин
> 14 днівЩоденно
ПараметрТипОпис
idstringID сервісу
fromstringДата початку ISO 8601 (запит)
tostringДата завершення ISO 8601 (запит)

Максимальний діапазон: 90 днів. Обмеження швидкості: 30 req/min на IP.

Відповідь

{
  "granularity": "hour",
  "from": "2026-04-09 12:00:00",
  "to": "2026-04-10 12:00:00",
  "points": [
    { "t": "2026-04-09 12:00:00", "up": 58, "down": 2, "avgMs": 42, "uptimePct": 96.67 }
  ],
  "timeline": [
    { "from": "2026-04-09 12:00:00", "to": "2026-04-09 14:32:00", "status": "up" },
    { "from": "2026-04-09 14:32:00", "to": "2026-04-09 14:58:00", "status": "down" }
  ]
}