REST API и MCP

Что можно автоматизировать

REST API подходит для интеграций, отчетов, внутренних панелей и CI/CD. MCP нужен для AI-агентов, которые должны читать состояние проекта, разбирать инциденты и выполнять действия только после явного подтверждения.

Авторизация

API-ключи и MCP-токены создаются в личном кабинете в разделе API и MCP. Полный токен показывается один раз сразу после создания.

Authorization: Bearer upv_api_xxx
Content-Type: application/json

Передавайте токены только через заголовок Authorization. Не кладите токены в URL, query string, публичные логи или клиентский JavaScript.

Базовые правила REST API

Методы REST API

Методы чтения работают с ключом read. Методы создания, обновления и изменения состояния требуют ключ write.

Поля монитора

Эти поля используются в POST /api/v1/monitors, PATCH /api/v1/monitors/:id и инструментах MCP monitor_create, monitor_update.

Дополнительные проверки внутри HTTP/S

Проверка домена, SSL и DNS A-записи включаются внутри HTTP/S-монитора и не создают отдельный публичный монитор в списке.

Примеры REST-запросов

Получить мониторы

GET https://upvisor.online/api/v1/monitors?page=1&per_page=100
Authorization: Bearer upv_api_xxx

200 OK
{
  "monitors": [
    {
      "id": 12,
      "name": "API",
      "type": "http",
      "target": "https://example.com/api",
      "timezone": "Europe/Moscow",
      "status": "up",
      "last_checked_at": "2026-07-14T09:10:00.000Z",
      "last_response_ms": 184,
      "created_at": "2026-07-11T12:00:00.000Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 100,
    "total": 1,
    "pages": 1
  }
}

Создать HTTP/S-монитор

curl -X POST https://upvisor.online/api/v1/monitors \\
  -H "Authorization: Bearer upv_api_xxx" \\
  -H "Content-Type: application/json" \\
  -d '{
    "name": "Main website",
    "type": "http",
    "target": "example.com",
    "interval_seconds": 300,
    "regions": ["msk", "spb"],
    "follow_redirects": true,
    "auto_ssl_check": true,
    "auto_domain_check": true,
    "auto_dns_a_check": true,
    "auto_dns_a_expected": "87.228.109.126"
  }\'

201 Created
{
  "id": 42,
  "heartbeat_url": null
}

Создать Heartbeat-монитор

curl -X POST https://upvisor.online/api/v1/monitors \\
  -H "Authorization: Bearer upv_api_xxx" \\
  -H "Content-Type: application/json" \\
  -d '{
    "name": "night-export",
    "type": "heartbeat",
    "target": "night-export",
    "interval_seconds": 43200,
    "config": {
      "heartbeat_grace_minutes": 10
    }
  }\'

201 Created
{
  "id": 51,
  "heartbeat_url": "https://upvisor.online/heartbeat/hb_xxx"
}

Плановые работы

curl -X POST https://upvisor.online/api/v1/maintenance \\
  -H "Authorization: Bearer upv_api_xxx" \\
  -H "Content-Type: application/json" \\
  -d '{
    "title": "Обновление БД",
    "description": "Обновление базы данных и миграции",
    "timezone": "Europe/Moscow",
    "starts_at": "2026-07-15 02:00:00",
    "ends_at": "2026-07-15 04:00:00",
    "monitor_ids": [42, 43],
    "suppress_alerts": true,
    "show_on_status_page": true
  }\'

201 Created
{
  "id": 7
}

Поля ответов

Ошибки REST API

Ошибки возвращаются JSON-объектом с коротким кодом в поле error. Подробный справочник есть в разделе Коды ошибок.

MCP endpoint

MCP работает через JSON-RPC 2.0 по адресу https://upvisor.online/mcp. Доступен на тарифах Pro и Team. Авторизация такая же: Authorization: Bearer upv_mcp_xxx.

curl -X POST https://upvisor.online/mcp \\
  -H "Authorization: Bearer upv_mcp_xxx" \\
  -H "Content-Type: application/json" \\
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "monitor_list",
      "arguments": {
        "status": "down",
        "limit": 20
      }
    }
  }\'

Защита MCP от случайных изменений

Инструменты чтения работают сразу. Инструменты, которые создают, обновляют, публикуют, удаляют или отправляют уведомления, требуют MCP-токен с правом write и аргумент confirm: true.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "monitor_pause",
    "arguments": {
      "monitor_id": 42,
      "action": "pause",
      "confirm": true
    }
  }
}

Инструменты MCP

Ниже — основные инструменты. Совместимые aliases list_monitors, get_monitor, get_monitor_checks, list_incidents, list_status_pages оставлены для старых клиентов, но новые интеграции лучше строить на именах monitor_*, incident_*, status_page_*.

Значения аргументов MCP

Примеры MCP-команд

Показать недоступные серверы

{
  "jsonrpc": "2.0",
  "id": 10,
  "method": "tools/call",
  "params": {
    "name": "monitor_list",
    "arguments": {
      "status": "down",
      "limit": 20
    }
  }
}

Создать heartbeat-сервер

{
  "jsonrpc": "2.0",
  "id": 11,
  "method": "tools/call",
  "params": {
    "name": "monitor_create",
    "arguments": {
      "confirm": true,
      "name": "night-export",
      "type": "heartbeat",
      "target": "night-export",
      "interval_seconds": 43200,
      "config": {
        "heartbeat_grace_minutes": 10
      }
    }
  }
}

Сгенерировать AI-сводку инцидента

{
  "jsonrpc": "2.0",
  "id": 12,
  "method": "tools/call",
  "params": {
    "name": "incident_generate_ai_summary",
    "arguments": {
      "confirm": true,
      "incident_id": 128,
      "force": false
    }
  }
}