API аналітики
Точки кінця аналітики FonProxy: графіки трафіку, кількість запитів, конкуренція, розподіл по доменах, помилки та веб-сайти.
Для аутентифікації та заголовків дивіться API Загальне.
Усі кінцеві точки графіків та розподілу приймають параметри from та to у вигляді рядків дати ISO 8601 (максимальний діапазон 2 місяці).
Додаткові фільтри: domain (точна відповідність), orderId (ID).
Збір даних
Збір логів Auth required
POST /analytics/ingest
Надішліть заздалегідь агреговані журнали запитів від проксі-робітників.
Тіло запиту
{
"logs": [
{
"ts": "2026-03-15 10:15:00",
"user_id": 1,
"order_id": 3,
"port": 443,
"protocol": "HTTPS",
"ip_out": "185.199.100.10",
"ip_from": "78.100.50.12",
"peer_id": "peer-001",
"worker": "worker-01",
"domain": "google.com",
"error": "",
"count": 12,
"bytes_sent": 10240,
"bytes_received": 524800,
"error_count": 0,
"duration_ms": 15000,
"max_concurrency": 5
},
...
]
}Відповідь
204 No Content
Графіки
Графік трафіку Auth required
GET /analytics/traffic
Дані графіка — байти, надіслані/отримані з часом.
Параметри запиту
| Ім’я | Тип | Опис | Необхідність |
|---|---|---|---|
from | string | Дата початку (ISO 8601) | Так |
to | string | Дата закінчення (ISO 8601) | Так |
domain | string | Фільтр за точним доменом | Ні |
orderId | string | Фільтр за замовленням | Ні |
Відповідь
{
"data": [
{
"bucket": "2026-03-15 00:00:00",
"total_bytes_sent": "1048576",
"total_bytes_received": "52428800",
"bytes_total": "53477376",
"total_count": "1542"
},
...
]
}Графік запитів Auth required
GET /analytics/requests
Дані графіка — кількість запитів з часом.
Параметри запиту
Ті ж, що й у Графіка трафіку.
Відповідь
{
"data": [
{
"bucket": "2026-03-15 00:00:00",
"total_count": "1542",
"total_errors": "23"
},
...
]
}Графік конкуренції Auth required
GET /analytics/concurrency
Дані графіка — конкуренція з часом.
Параметри запиту
Ті ж, що й у Графіка трафіку.
Відповідь
{
"data": [
{
"bucket": "2026-03-15 00:00:00",
"max_concurrency": "48",
"total_count": "1542"
},
...
]
}Розподіли
Розподіл доменів Auth required
GET /analytics/domains
Топ доменів за кількістю байтів або запитів.
Параметри запиту
| Ім’я | Тип | Опис | Необхідність |
|---|---|---|---|
from | string | Дата початку (ISO 8601) | Так |
to | string | Дата закінчення (ISO 8601) | Так |
sortBy | string | Сортувати за: bytes або count. За замовчуванням bytes | Ні |
limit | number | Максимальна кількість результатів (1–100). За замовчуванням 30 | Ні |
orderId | string | Фільтр за замовленням | Ні |
Відповідь
{
"data": [
{
"domain": "google.com",
"total_count": "5420",
"bytes_total": "268435456",
"total_bytes_sent": "5242880",
"total_bytes_received": "263192576",
"total_errors": "12"
},
...
]
}Розподіл помилок Auth required
GET /analytics/errors
Розподіл помилок, згрупованих за типом помилки.
Параметри запиту
| Ім’я | Тип | Опис | Необхідність |
|---|---|---|---|
from | string | Дата початку (ISO 8601) | Так |
to | string | Дата закінчення (ISO 8601) | Так |
domain | string | Фільтр за точним доменом | Ні |
orderId | string | Фільтр за замовленням | Ні |
limit | number | Максимальна кількість результатів (1–100). За замовчуванням 50 | Ні |
Відповідь
{
"data": [
{
"error": "ECONNREFUSED",
"total_errors": "142",
"first_seen": "2026-02-01 08:15:00",
"last_seen": "2026-03-19 22:45:00",
"sample_domains": ["google.com", "facebook.com", "github.com"]
},
...
]
}Веб-сайти
Список веб-сайтів Auth required
GET /analytics/websites
Відвідані веб-сайти — пагінований список різних доменів.
Параметри запиту
| Ім’я | Тип | Опис | Необхідність |
|---|---|---|---|
from | string | Дата початку (ISO 8601) | Так |
to | string | Дата закінчення (ISO 8601) | Так |
domain | string | Фільтр за точним доменом | Ні |
orderId | string | Фільтр за замовленням | Ні |
page | number | Номер сторінки. За замовчуванням 1 | Ні |
limit | number | Кількість елементів на сторінку (1–100). За замовчуванням 25 | Ні |
Відповідь
{
"data": [
{
"domain": "google.com",
"total_count": "5420",
"bytes_total": "268435456",
"first_visit": "2026-02-01 08:15:00",
"last_visit": "2026-03-19 22:45:00"
},
...
],
"page": 1,
"limit": 25,
"total": 48,
"totalPages": 2
}