SEOньоритаДокументация API
API v1Расписания
Public API v1

Расписания

Расписание хранит IANA timezone, контекст и предел списания для каждого запуска. В съём входит весь актуальный контекст.

Создать расписание

POST/projects/{projectId}/automationsautomations:manage
Запросbash
curl -X POST "https://api.seonorita.ru/api/v1/projects/<projectId>/automations" \
  -H "Authorization: Bearer $SEO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: automation:weekly-main" \
  -d '{
    "name": "Позиции по понедельникам",
    "trackingContextId": "<contextId>",
    "timezone": "Europe/Moscow",
    "schedule": {
      "cadence": "WEEKLY",
      "hour": 6,
      "minute": 30,
      "weekdays": [1]
    },
    "maxPlatformChargeMicro": "12500000",
    "failureThreshold": 3,
    "enabled": true
  }'
201 · Сокращённый ответjson
{
  "data": {
    "id": "<automationId>",
    "name": "Позиции по понедельникам",
    "schedule": { "cadence": "WEEKLY", "hour": 6, "minute": 30, "weekdays": [1] },
    "timezone": "Europe/Moscow",
    "enabled": true,
    "nextRunAt": "2026-09-07T03:30:00.000Z",
    "version": 1
  },
  "meta": { "requestId": "01J...", "version": 1 }
}

Варианты schedule

JSON · Допустимые расписанияjson
{
  "once": {
    "cadence": "ONCE",
    "runAt": "2030-09-05T08:30:00.000Z"
  },
  "daily": {
    "cadence": "DAILY",
    "hour": 6,
    "minute": 30
  },
  "weekly": {
    "cadence": "WEEKLY",
    "hour": 6,
    "minute": 30,
    "weekdays": [1, 4]
  }
}

В WEEKLY дни недели нумеруются по ISO: 1 — понедельник, 7 — воскресенье. ONCE выполняется один раз и после завершения остаётся в истории. Лимита ключей в расписании нет: каждый запуск обрабатывает весь текущий список запросов выбранного контекста.

Пауза, запуск, изменение и удаление

PATCH, pause, resume и ручной POST /automations/{automationId}/runsтребуют актуальный If-Match. Ручной запуск также требует новый Idempotency-Key. Пустое тело передавайте как {}.

DELETE /automations/{automationId} также требует If-Match и пустое тело. Расписание исчезает из активного каталога и больше не запускается; выполненные операции и результаты сохраняются.