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: инциденты →