API

API: монітори

Як переглядати, створювати, змінювати, призупиняти та видаляти монітори через API Tenium.

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

GET /monitors?clientWorkspaceId=&type=&status=

Створення монітора

curl -X POST https://app.tenium.app/api/v1/monitors \
  -H "Authorization: Bearer tn_live_3f9a..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Client A shop",
    "type": "http",
    "url": "https://shop.clienta.com",
    "intervalSec": 30,
    "timeoutSec": 10,
    "regions": ["fra", "lon", "ams", "nyc", "sfo", "sgp"],
    "expectedStatus": ["2xx", "3xx"],
    "keyword": { "mode": "contains", "value": "Add to cart" },
    "headers": { "x-tenium-secret": "YOUR_SECRET" },
    "contactIds": ["6d2c9f1e-0b7a-4b5e-9d3c-5a1f2e8b7c4d"],
    "clientWorkspaceId": null,
    "tags": ["woocommerce", "client-a"]
  }'

Відповідь 201 Created:

{
  "id": "a3f1c2d4-9e8b-4f6a-b7c5-1d2e3f4a5b6c",
  "accountId": "0f8e7d6c-5b4a-4392-8172-6f5e4d3c2b1a",
  "clientWorkspaceId": null,
  "name": "Client A shop",
  "type": "http",
  "url": "https://shop.clienta.com",
  "intervalSec": 30,
  "timeoutSec": 10,
  "regions": ["fra", "lon", "ams", "nyc", "sfo", "sgp"],
  "expectedStatus": ["2xx", "3xx"],
  "keyword": { "mode": "contains", "value": "Add to cart" },
  "headers": { "x-tenium-secret": "••••" },
  "status": "pending",
  "paused": false,
  "contactIds": ["6d2c9f1e-0b7a-4b5e-9d3c-5a1f2e8b7c4d"],
  "tags": ["woocommerce", "client-a"],
  "lastCheckAt": null,
  "nextCheckAt": "2026-01-20T10:15:03Z",
  "createdAt": "2026-01-20T10:15:00Z",
  "updatedAt": "2026-01-20T10:15:00Z"
}

intervalSec менший за мінімум тарифу повертає 422 із кодом plan_limit. Значення секретних заголовків у кожній відповіді маскуються.

Поля за типами

Тип	Обов’язкові	Необов’язкові
http, keyword, json	`url`	`method`, `body`, `headers`, `expectedStatus`, `keyword`, `assertions`
ping	`host`	`packets`, `lossThreshold`
port	`host`, `port`	`protocol` (tcp/udp), `send`, `expect`
dns	`host`, `recordType`	`expected`, `resolver`
ssl	`host`	`port`, `warnDays`
domain	`host`	`warnDays`
heartbeat	`periodSec` або `cron`	`graceSec`, `timezone`

Зміна

PATCH /monitors/{id}

Надсилайте лише ті поля, які треба змінити.

Призупинення й відновлення

POST /monitors/{id}/pause
POST /monitors/{id}/resume

Перевірити зараз

POST /monitors/{id}/check

Ставить у чергу негайну перевірку з кожного регіону. Обмеження: один запит на монітор за 10 секунд.

Видалення

DELETE /monitors/{id}

Повертає 204. Історія зберігається 30 днів, щоб можна було скасувати видалення, потім її стирають.

Історія перевірок

GET /monitors/{id}/checks?from=&to=&region=

Повертає результати окремих перевірок із часовими показниками. Термін зберігання залежить від тарифу (від 90 до 730 днів).

← API: автентифікація API: інциденти →