> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Обзор API LanderLab

> Как работает REST API LanderLab: авторизация по API-ключу, а затем программное управление лендингами, лидами, A/B-тестами, аналитикой и доменами.

API LanderLab даёт программный доступ ко всему вашему аккаунту. Через HTTP можно создавать и публиковать лендинги, получать данные лидов, читать аналитику, управлять вариантами A/B-тестов, настраивать интеграции и многое другое.

Если вы предпочитаете работать обычными словами, а не писать вызовы API вручную, [MCP-сервер](/ru/mcp/overview) подключает вашего AI-ассистента напрямую к LanderLab через тот же API. Вход выполняется через аккаунт LanderLab, поэтому API-ключ не нужен.

## Базовый URL

Все запросы к API отправляются на:

```text theme={null}
https://api.landerlab.dev
```

Текущая версия API — **v2**. Все эндпоинты начинаются с префикса `/api/v2/`.

## Аутентификация

API использует аутентификацию по API-ключу. Передавайте ключ в заголовке `X-API-Key` в каждом запросе.

```text theme={null}
X-API-Key: ll_live_YOUR_KEY_HERE
```

Ключ начинается с `ll_live_` и привязан к вашей организации. Все запросы ограничены организацией, которой принадлежит ключ, поэтому в большинстве вызовов ID организации отдельно передавать не нужно.

<Note>
  API-ключи показываются только один раз при создании. Если вы потеряли ключ, нужно сгенерировать новый. Шаги см. в разделе [Генерация API-ключа](/ru/mcp/generate-api-key).
</Note>

### Ответы с ошибками

Все эндпоинты возвращают стандартные HTTP-коды состояния.

| Код | Значение |
| - | - |
| `200` | Успех |
| `400` | Неверный запрос (некорректные параметры или достигнут лимит тарифа) |
| `401` | Не авторизован (API-ключ отсутствует или недействителен) |
| `403` | Доступ запрещён (у ключа нет доступа к этому ресурсу) |
| `404` | Не найдено |

Ответы с ошибками содержат в теле строку `error` с описанием проблемы.

## Группы ресурсов

API организован по следующим группам ресурсов. Каждая группа соответствует разделу в справочнике API.

### Рабочие пространства

Просмотр, создание и переименование рабочих пространств в вашей организации. Рабочие пространства — контейнер верхнего уровня для лендингов, лидов и доменов.

| Эндпоинт | Описание |
| - | - |
| `GET /api/v2/organizations/{organizationId}/workspaces/get` | Список всех рабочих пространств |
| `POST /api/v2/organizations/{organizationId}/workspaces/create` | Создать рабочее пространство |
| `POST /api/v2/workspaces/{workspaceId}/rename` | Переименовать рабочее пространство |

### Лендинги

Управление лендингами: просмотр списка, создание, переименование, публикация, снятие с публикации и удаление. Для публикации нужны домен и путь; если превышены лимиты тарифа или путь уже занят, вернётся ошибка `400`.

| Эндпоинт | Описание |
| - | - |
| `GET /api/v2/workspaces/{workspaceId}/landers/get` | Список лендингов в рабочем пространстве |
| `POST /api/v2/workspaces/{workspaceId}/landers/create` | Создать лендинг |
| `POST /api/v2/landers/{landerId}/publish` | Опубликовать лендинг |
| `POST /api/v2/landers/{landerId}/unpublish` | Снять лендинг с публикации |
| `DELETE /api/v2/landers/{landerId}` | Удалить лендинг со всеми его вариантами |

При удалении лендинга все связанные варианты, файлы и интеграции удаляются безвозвратно.

### A/B-тестирование (варианты)

У каждого лендинга есть один или несколько вариантов. Основной (master) вариант получает трафик, когда A/B-тестирование выключено. Когда A/B-тестирование включено, трафик распределяется между вариантами согласно заданным весам.

| Эндпоинт | Описание |
| - | - |
| `GET /api/v2/landers/{landerId}/variants` | Список всех вариантов |
| `POST /api/v2/variants/{variantId}/clone` | Клонировать вариант |
| `POST /api/v2/landers/{landerId}/ab-testing/enable` | Включить A/B-тестирование |
| `POST /api/v2/landers/{landerId}/ab-testing/disable` | Выключить A/B-тестирование |
| `POST /api/v2/landers/{landerId}/ab-testing/weights` | Задать веса распределения трафика |
| `POST /api/v2/variants/{variantId}/set-master` | Сделать вариант основным |
| `DELETE /api/v2/variants/{variantId}` | Удалить вариант |

Удалить основной вариант нельзя. Сначала назначьте основным другой вариант.

### Редактор

Загрузка и сохранение HTML-содержимого и настроек конкретного варианта. При сохранении HTML изображения в base64 извлекаются, а версии создаются автоматически.

| Эндпоинт | Описание |
| - | - |
| `GET /api/v2/variants/{variantId}/editor/load` | Загрузить HTML, настройки, формы и метаданные |
| `POST /api/v2/variants/{variantId}/editor/save` | Сохранить HTML-содержимое |
| `POST /api/v2/variants/{variantId}/editor/settings` | Сохранить настройки варианта (интеграции, SEO, отслеживание) |

### Лиды

Получение лидов на уровне рабочего пространства или организации. Лиды выдаются постранично и фильтруются по диапазону дат, статусу (`complete` или `partial`), лендингу и поисковому запросу. Максимальный размер страницы — 1000 записей за запрос.

| Эндпоинт | Описание |
| - | - |
| `GET /api/v2/workspaces/{workspaceId}/leads/get` | Список лидов рабочего пространства |
| `GET /api/v2/organizations/{organizationId}/leads/get` | Список лидов по всей организации |
| `GET /api/v2/landers/{landerId}/lead-schema` | Получить JSON Schema лидов лендинга |
| `POST /api/v2/landers/lead-schema` | Получить JSON Schema для нескольких лендингов |

Эндпоинты схемы лидов возвращают [JSON Schema Draft-07](https://json-schema.org/specification-links#draft-7), описывающую все возможные поля лида с этого лендинга: поля форм, ответы квизов, системные поля и поля интеграций.

### Аналитика

Один гибкий эндпоинт покрывает все задачи аналитики. Фильтровать можно по рабочему пространству, лендингу или варианту. Побеждает самый конкретный фильтр: если передать `variantIds`, фильтры по рабочему пространству и лендингу игнорируются.

| Эндпоинт | Описание |
| - | - |
| `POST /api/v2/organizations/{organizationId}/analytics/get` | Получить аналитику с диапазоном дат, часовым поясом и необязательной группировкой |

**Обязательные параметры:** `startDate`, `endDate`, `timezone` (формат IANA, например `America/New_York`).

**Необязательные фильтры:** `workspaceIds`, `landerIds`, `variantIds`.

**Группировка:** `date`, `lander`, `variant` или `workspace`. По умолчанию — `date`.

### Домены

Просмотр доменов на уровне рабочего пространства или организации.

| Эндпоинт | Описание |
| - | - |
| `GET /api/v2/workspaces/{workspaceId}/domains/get` | Список доменов рабочего пространства |
| `GET /api/v2/organizations/{organizationId}/domains/get` | Список всех доменов организации |

### Папки

Организация лендингов по папкам внутри рабочего пространства.

| Эндпоинт | Описание |
| - | - |
| `GET /api/v2/workspaces/{workspaceId}/folders` | Список всех папок |
| `POST /api/v2/workspaces/{workspaceId}/folders/create` | Создать папку |
| `POST /api/v2/folders/{folderId}/rename` | Переименовать папку |

### Интеграции

Создание и просмотр интеграций на уровне организации, а затем включение или отключение их для отдельных лендингов. Интеграции на основе OAuth (Mailchimp, HubSpot, Google Sheets, AWeber) требуют интерактивной авторизации OAuth и не могут быть созданы напрямую через API.

| Эндпоинт | Описание |
| - | - |
| `GET /api/v2/organizations/{organizationId}/integrations` | Список всех интеграций |
| `POST /api/v2/organizations/{organizationId}/integrations/create` | Создать интеграцию |
| `POST /api/v2/lander-integrations/{id}/enable` | Включить интеграцию лендинга |
| `POST /api/v2/lander-integrations/{id}/disable` | Отключить интеграцию лендинга |
| `DELETE /api/v2/lander-integrations/{id}` | Удалить интеграцию с лендинга |

## Спецификация OpenAPI и интерактивная документация

Полная спецификация OpenAPI 3.1 доступна по адресу:

```text theme={null}
https://backend-v2.landerlab.workers.dev/api/v2/openapi.json
```

Интерактивная документация API (со встроенным тестером запросов) находится здесь:

```text theme={null}
https://api.landerlab.dev/api/v2/docs
```

## Работа с API через AI-ассистента (MCP)

Если вы хотите управлять аккаунтом LanderLab обычными словами, а не писать вызовы API, MCP-сервер LanderLab построен на том же API и предоставляет более 30 инструментов любому MCP-совместимому AI-ассистенту, включая Claude, ChatGPT, Cursor и Windsurf.

URL MCP-сервера:

```text theme={null}
https://api.landerlab.dev/mcp
```

Авторизация проходит через вход в браузере, а не через заголовок `X-API-Key`, поэтому API-ключ не требуется. Инструкции по настройке см. в разделе [Подключение AI-ассистентов через MCP](/ru/mcp/overview).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.