Public API v1

Проекты

Читайте список доступных проектов и изменяйте versioned-настройки с If-Match.

GET/workspaces/{workspaceId}/projectsprojects:read GET/workspaces/{workspaceId}/project-capabilitiesprojects:read POST/workspaces/{workspaceId}/projectsprojects:write PUT/workspaces/{workspaceId}/projects/orderprojects:write GET/projects/{projectId}projects:read PATCH/projects/{projectId}projects:write POST/projects/{projectId}/archiveprojects:write POST/projects/{projectId}/restoreprojects:write DELETE/projects/{projectId}projects:write

Список проектов

GET/workspaces/{workspaceId}/projectsprojects:read

Запросbash

curl "https://api.seonorita.ru/api/v1/workspaces/<workspaceId>/projects" \
  -H "Authorization: Bearer $SEO_API_TOKEN"

Ответ — полная коллекция в общем сохранённом порядке. Для ключа с выбранными проектами сервер отфильтрует остальные проекты до формирования ответа.

Изменение проекта

PATCH/projects/{projectId}projects:write

Запросbash

curl -X PATCH "https://api.seonorita.ru/api/v1/projects/<projectId>" \
  -H "Authorization: Bearer $SEO_API_TOKEN" \
  -H 'If-Match: "v4"' \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Нейролюб",
    "domain": "neurolub.ru"
  }'

200 · Ответjson

{
  "data": {
    "id": "019fb800-b45b-7852-8a4e-a17d20f30cbd",
    "name": "Нейролюб",
    "domain": "neurolub.ru",
    "status": "ACTIVE",
    "version": 5,
    "createdAt": "2026-08-12T09:00:00.000Z"
  },
  "meta": { "requestId": "01J...", "version": 5 }
}

Новую версию также возвращает ETag: "v5". При устаревшем If-Match перечитайте проект и повторите осознанное изменение.

Общий порядок проектов

PUT/workspaces/{workspaceId}/projects/orderprojects:write

Порядок общий для всей рабочей области. Передайте одновременно последний увиденный список и новый полный список. Если другой пользователь уже изменил порядок, API вернёт 412. Команда доступна только ключу со всеми проектами и пользователю с полным доступом к рабочей области.

Запросbash

curl -X PUT "https://api.seonorita.ru/api/v1/workspaces/<workspaceId>/projects/order" \
  -H "Authorization: Bearer $SEO_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "expectedProjectIds": ["01900000-0000-7000-8000-000000000101", "01900000-0000-7000-8000-000000000102"],
    "projectIds": ["01900000-0000-7000-8000-000000000102", "01900000-0000-7000-8000-000000000101"]
  }'

200 · Ответjson

{
  "data": {
    "projectIds": [
      "01900000-0000-7000-8000-000000000102",
      "01900000-0000-7000-8000-000000000101"
    ]
  },
  "meta": { "requestId": "01J..." }
}