Лендинги

Через API лендинги можно только найти: список нужен, чтобы взять идентификатор лендинга и подключить его к PWA как белую страницу. Загружают и редактируют лендинги в панели, см. раздел «Лендинги».

Метод	Адрес	Что делает
GET	/landings	Список лендингов

Замените ВАШ_КЛЮЧ и panel.example.com на свои.

Список лендингов

GET/landings

Лендинги ваших команд, недавно изменённые сверху. Архивные не показываются.

Параметр	Что фильтрует
search	Часть названия
team_id	Команда
group_id	Группа доступа
archived	1 - только архивные
page, per_page	Страница и её размер (по умолчанию 100)

curl

curl "https://panel.example.com/api/landings?search=Promo" \
  -H "Authorization: Bearer ВАШ_КЛЮЧ" \
  -H "Accept: application/json"

PHP

<?php
// composer require guzzlehttp/guzzle
require 'vendor/autoload.php';

$api = new GuzzleHttp\Client([
    'base_uri' => 'https://panel.example.com/api/',
    'headers' => ['Authorization' => 'Bearer ВАШ_КЛЮЧ', 'Accept' => 'application/json'],
    'timeout' => 30,
]);

$response = $api->get('landings', ['query' => ['search' => 'Promo']]);
$landings = json_decode($response->getBody(), true)['data']['landings'];

foreach ($landings as $landing) {
    echo "{$landing['id']} {$landing['name']}" . PHP_EOL;
}

Python

# pip install requests
import requests

API = "https://panel.example.com/api"
HEADERS = {"Authorization": "Bearer ВАШ_КЛЮЧ", "Accept": "application/json"}

response = requests.get(f"{API}/landings", headers=HEADERS, params={"search": "Promo"}, timeout=30)
landings = response.json()["data"]["landings"]

for landing in landings:
    print(landing["id"], landing["name"])

Node.js

// Node.js 18+, без зависимостей; сохраните как script.mjs
const API = 'https://panel.example.com/api';
const headers = { Authorization: 'Bearer ВАШ_КЛЮЧ', Accept: 'application/json', 'Content-Type': 'application/json' };

const response = await fetch(`${API}/landings?search=Promo`, { headers, signal: AbortSignal.timeout(30000) });
const { data } = await response.json();

for (const landing of data.landings) {
  console.log(landing.id, landing.name);
}

Ответ

{
  "data": {
    "meta": { "current_page": 1, "per_page": 100, "last_page": 1, "total": 1 },
    "landings": [
      {
        "id": "WZAX",
        "name": "Promo LP",
        "type": "prelanding",
        "archived": false,
        "created_at": "05 Oct 2026 14:23",
        "updated_at": "05 Oct 2026 14:23",
        "team": { "id": "WQby", "name": "Team A" },
        "user": { "id": "WZAX", "name": "Buyer", "email": "[email protected]" },
        "groups": []
      }
    ]
  }
}

type - вид страницы: white_page (белая страница) или prelanding (прелендинг).

Ошибки - только общие, см. «Введение в API».

Подключить лендинг к PWA

Лендинг подключается в настройках PWA: в config.general.white укажите type: "load" и идентификатор лендинга в value. Лендинг должен быть в одной из ваших команд.

{
  "config": {
    "general": {
      "white": { "type": "load", "value": "WZAX" }
    }
  }
}

Как отправить изменённые настройки, см. «Изменение, включение и выключение» в разделе API «PWA»: config заменяется целиком, поэтому сначала получите текущий.

Ошибки

Код	message	Когда
422	The selected white page landing is invalid.	В value - несуществующий лендинг
422	You do not have access to this resource	Лендинг не вашей команды