Огляд API

Cronitorex надає два API, кожен зі своїм власним API ключем:

API	Базовий URL	Префікс ключа	Призначення
Ingest API	https://api.cronitorex.com	ck_	Прийом подій моніторингу (пінгів) від ваших задач і сервісів
Management API	https://app.cronitorex.com/api/v1	mk_	Керування моніторами як маніфест-документами: список, отримання, створення, оновлення

Автентифікація

Обидва API автентифікуються Bearer токеном, але кожен використовує свій власний ключ:

Authorization: Bearer <api_key>

• Ключ Ingest API (ck_...) автентифікує лише пінги.
• Ключ Management API (mk_...) автентифікує лише /api/v1.

Згенеруйте обидва ключі в панелі в розділі Settings → API key. Ingest API додатково приймає параметр запиту ?api_key= для разових GET пінгів (дивіться GET /ping).

Тип вмісту

Усі тіла запитів мають бути application/json. Усі відповіді також application/json.

Ліміти запитів

Кожен API має власний ліміт:

API	Ліміт	При перевищенні
Ingest API	10 запитів/секунду, сплеск до 20	429 Too Many Requests
Management API	60 запитів/хвилину на API ключ	429 + заголовки X-RateLimit-Limit / X-RateLimit-Remaining

Ендпоінти

Ingest API

Метод	Шлях	Опис
POST	/ping	Надішліть подію моніторингу, дивіться POST /ping
GET	/ping/{monitor}	Надішліть подію через параметри запиту, дивіться GET /ping
GET	/health	Перевірка стану API (автентифікація не потрібна)

Словник статусів і типи подій: Типи та стани подій.

Management API

Метод	Шлях	Опис
GET	/api/v1/monitors	Список маніфестів моніторів (фільтр через ?kind=)
GET	/api/v1/monitors/{uuid}	Отримати окремий монітор
POST	/api/v1/monitors	Створити монітор з маніфесту
PUT	/api/v1/monitors/{uuid}	Оновити монітор (повний маніфест)
DELETE	/api/v1/monitors/{uuid}	Не підтримується, повертає 403; видалення можливе лише через панель за задумом

Повний довідник з форматом маніфесту: Management API.

Інтерактивні інструменти

• Swagger UI, спробуйте обидва API прямо в браузері
• Колекція Postman, готові запити для всіх ендпоінтів