Лендинги

Лендинг — это публичная воронка, которую TEASE отдаёт на одном из ваших доменов. Вы собираете её из упорядоченных гео-сегментов, стопки кнопок для каждого сегмента, необязательного баннера-уведомления и фона — всё это редактируется как черновик, просматривается вживую, а затем публикуется одним атомарным шагом.

Любое изменение, которое вы делаете через API, записывается только в состояние черновика. Боевая страница не меняется, пока вы не вызовете /publish. Это даёт безопасный цикл «редактирование — предпросмотр — выпуск» с единым глобальным откатом (/discard).

Концепции

Домены

Запись домена — это якорь для всего лендинга. Получите список доменов, которыми вы владеете, создавайте новые и копируйте готовую страницу на другой домен.

Список доменов

curl https://app.tease.link/api/admin/domains \
  -H "Authorization: Bearer $TEASE_API_KEY"

const res = await fetch('https://app.tease.link/api/admin/domains', {
  headers: { Authorization: `Bearer ${process.env.TEASE_API_KEY}` },
});
const { items } = await res.json();

import os, requests

res = requests.get(
    "https://app.tease.link/api/admin/domains",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
)
items = res.json()["items"]

{
  "items": [
    {
      "hostname": "links.creator.com",
      "display_name": "Instagram bio",
      "created_at": 1751280000,
      "button_count": 4,
      "infra_state": "ssl_active",
      "provisioning_error": null,
      "infra_attempted_at": 1751280000
    }
  ]
}

Каждая запись несёт infra_state, который управляет статус-бейджем в дашборде:

Создать домен

curl -X POST https://app.tease.link/api/admin/domains \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "hostname": "links.creator.com", "display_name": "Instagram bio" }'

const res = await fetch('https://app.tease.link/api/admin/domains', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TEASE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ hostname: 'links.creator.com', display_name: 'Instagram bio' }),
});
const domain = await res.json();

res = requests.post(
    "https://app.tease.link/api/admin/domains",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    json={"hostname": "links.creator.com", "display_name": "Instagram bio"},
)
domain = res.json()

Параметры

Новый домен создаётся с infra_state: "provisioning" и засеивается тремя дефолтными гео-сегментами плюс пустыми записями уведомления/фона, так что он сразу доступен для редактирования. Повторное создание хоста, которым вы уже владеете, в течение минуты возвращает существующую запись (идемпотентный повтор); иначе дубликат возвращает 409 domain_taken.

Переименовать или удалить домен

PATCH обновляет display_name (это только отчётные метаданные, и они вступают в силу без публикации). DELETE удаляет домен и каскадно удаляет его кнопки, сегменты, баннер и фон.

# Rename
curl -X PATCH https://app.tease.link/api/admin/domains/links.creator.com \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "display_name": "TikTok bio" }'

# Delete
curl -X DELETE https://app.tease.link/api/admin/domains/links.creator.com \
  -H "Authorization: Bearer $TEASE_API_KEY"

await fetch('https://app.tease.link/api/admin/domains/links.creator.com', {
  method: 'PATCH',
  headers: {
    Authorization: `Bearer ${process.env.TEASE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ display_name: 'TikTok bio' }),
});

requests.patch(
    "https://app.tease.link/api/admin/domains/links.creator.com",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    json={"display_name": "TikTok bio"},
)

Скопировать страницу на другой домен

copy-from заменяет черновые кнопки и сегменты целевого домена копиями из домена-source — полный клон черновика, который вы затем публикуете. Страница пересобирается со свежими идентичностями кнопок, чтобы боевая страница обновилась чисто.

curl -X POST https://app.tease.link/api/admin/domains/new-site.com/copy-from \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "source": "links.creator.com" }'

Кастомные домены

Чтобы отдавать страницу на собственном домене, подключите его и подтвердите DNS. Подключение — это маленький конечный автомат, построенный на infra_state: запрос на подключение открывает домен в pending_dns, а успешная проверка переводит его в активное состояние.

curl -X POST https://app.tease.link/api/admin/domains/connect \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "hostname": "links.creator.com" }'

{
  "domain_id": 42,
  "hostname": "links.creator.com",
  "is_apex": false,
  "state": "pending_dns",
  "instructions": { "record_type": "CNAME", "name": "links", "value": "…" },
  "verify_url": "/api/admin/domains/42/verify"
}

{
  "domain_id": 42,
  "hostname": "links.creator.com",
  "state": "pending_dns",
  "issues": ["CNAME not found"]
}

{
  "domain_id": 42,
  "hostname": "links.creator.com",
  "state": "active",
  "url": "https://links.creator.com"
}

Конечный автомат намеренно мал — из pending_dns есть только два исхода:

Сегменты

Гео-сегмент — это корзина аудитории. Посетители сопоставляются с первым сегментом, чьи условия подходят, проваливаясь к единственному дефолтному catch-all. У каждого сегмента своя упорядоченная стопка кнопок, так что вы можете показывать разную воронку, скажем, мобильному трафику из США, и всем остальным.

Сегмент сопоставляется в первую очередь по стране. Опционально вы можете сузить его условиями отображения по устройству, ОС или времени суток и пометить целевым языком для авто-перевода.

У сегментов своя вкладка «Сегменты» в хабе домена (/domains/<домен>/segments), рядом с «Кнопками». Там все сегменты — карточками в порядке приоритета (кто выше, тот матчится первым): их страны и условия, флаги «по умолчанию» / «блок», A/B-набор кнопок и стрелки приоритета. Сами кнопки сегмента по-прежнему настраиваются во вкладке «Кнопки».

Тиры стран

У аккаунта есть три переиспользуемых тира стран, общих для всех доменов:

• Tier 1 — ваши топовые платящие рынки.
• Tier 2 — средние рынки.
• Блок-лист — страны, которым вы показываете 403 (они не попадают в воронку).

Они делают две вещи: пресеты T1 / T2 в редакторе сегмента добавляют страны из вашего Tier 1 / Tier 2 в собираемый сегмент, а трафик автоматически делится по тиру в A/B (Tier 1 сильнее склоняется к платному офферу, чем Tier 2).

Тиры остаются «за кулисами» — они питают пресет-чипы и A/B-деление, а не отдельный экран настроек. У каждого аккаунта разумные значения по умолчанию; чтобы их изменить, используйте API/MCP get_config / set_config (ключ geo_classify — { "tier1": [...], "tier2": [...], "blocklist": [...] } из ISO-3166 alpha-2 кодов). Ваши изменения касаются только вашего аккаунта.

Список сегментов

curl https://app.tease.link/api/admin/segments/links.creator.com \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "domain": "links.creator.com",
  "items": [
    {
      "segment_id": "s_1a2b3c4d",
      "domain": "links.creator.com",
      "name": "US mobile",
      "countries": ["US"],
      "position": 0,
      "is_default": false,
      "match": [{ "type": "device", "op": "is", "values": ["mobile"] }],
      "ab": null,
      "lang": ""
    },
    {
      "segment_id": "s_default",
      "domain": "links.creator.com",
      "name": "Everyone",
      "countries": [],
      "position": 1,
      "is_default": true,
      "match": null,
      "ab": null,
      "lang": ""
    }
  ]
}

Создать сегмент

curl -X POST https://app.tease.link/api/admin/segments/links.creator.com \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "US mobile",
    "countries": ["US"],
    "match": { "all": [{ "type": "device", "op": "is", "values": ["mobile"] }] }
  }'

Параметры

Условия match

Условие match сужает сегмент за пределы страны. Каждое условие — одно из:

Внутри условия values объединяются через OR; между условиями в all условия объединяются через AND.

Редактировать, переупорядочить, удалить

PATCH принимает любое подмножество полей создания. Опущенное поле остаётся неизменным; отправка явного пустого набора условий очищает его.

# Edit
curl -X PATCH https://app.tease.link/api/admin/segments/links.creator.com/s_1a2b3c4d \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "countries": ["US", "CA"] }'

# Reorder — the list must be a permutation of the domain's current segment ids
curl -X PUT https://app.tease.link/api/admin/segments/links.creator.com/order \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "order": ["s_1a2b3c4d", "s_default"] }'

# Delete — pass ?force=true to also remove the segment's buttons
curl -X DELETE "https://app.tease.link/api/admin/segments/links.creator.com/s_1a2b3c4d" \
  -H "Authorization: Bearer $TEASE_API_KEY"

Порядок важен: сегменты рассматриваются сверху вниз, поэтому размещайте наиболее специфичные сегменты выше catch-all. Переупорядочивание проверяет, что ваш массив order — это в точности текущий набор id сегментов (иначе order_mismatch). Удаление сегмента, у которого ещё есть кнопки, возвращает 409 segment_has_buttons, если только вы не передадите ?force=true; удаление дефолтного возвращает 400 segment_default_required, пока вы сначала не повысите другой сегмент.

Прямые редиректы

Иногда лендинг — лишний слой для аудитории: посетитель нужен сразу на назначении. Это закрывают два уровня прямых 307-редиректов, и оба оставляют каждый переход учтённым и атрибутированным, как обычный клик.

Сегменты-редиректы

Сегмент может быть помечен как сегмент-редирект: совпавший с ним посетитель не видит лендинг — его сразу 307-редиректит на назначение главной кнопки этого сегмента (самой нижней — той же, что лендинг красит основным CTA). Переход записывается как клик со своим источником, поэтому редиректнутые страны видны в отчётах трафика и питают TG-атрибуцию. Блок-сегмент всегда сильнее редиректа — заблокированная страна по-прежнему получает 403. Сам флаг включает платформа для гео-маршрутов в мессенджер; в редакторе сегментов такого переключателя пока нет.

Режим direct-redirect (на домен)

Целый домен может пропускать свой лендинг: при включённом режиме direct-redirect TEASE как обычно сопоставляет посетителя с гео-сегментом и затем 307-редиректит его прямо на назначение кнопки этого сегмента — для смартлинк-кнопки это /r/<slug> смарт-ссылка домена, так что лог кликов, привязка клик-id и атрибуция выручки продолжают работать насквозь. Режим создан для размещений, где промежуточная страница только теряет клики (например, adult-трафик из X/Twitter).

curl -X POST https://app.tease.link/api/admin/domains/links.creator.com/direct-redirect \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "enabled": true, "ab_pct": 0 }'

{ "domain": "links.creator.com", "direct_redirect": true, "ab_pct": 0 }

Все привычные предохранители остаются включёнными:

• Цель редиректа берётся из опубликованной страницы, поэтому переключатель не требует перепубликации и вступает в силу примерно за минуту. В панели он живёт кнопкой «Прямой редирект» рядом с «Импорт», над списком кнопок.
• Цель — главная кнопка аудитории, то есть самая нижняя (её же лендинг красит основной CTA). Настройка доменная: она действует во ВСЕХ аудиториях, и каждая уводит на свою главную кнопку.
• Сегменты-редиректы и блок-сегменты по-прежнему сильнее: совпавший сегмент-редирект шлёт свой 307 (например, в Telegram), а страна из блок-листа по-прежнему получает 403.
• Боты и сканеры назначение не видят — им не отдаётся ничего, ровно как в слое клоакинга.
• In-app webview (встроенные браузеры Instagram / Facebook / TikTok) всё же получает лендинг: внутри «закрытого» webview назначение не откроется, поэтому там должен отработать клиентский «выход» со страницы.
• Если у совпавшего сегмента нет назначения для редиректа — отдаётся лендинг (fail-safe, мёртвых редиректов не бывает).

A/B: лендинг vs сразу-на-оффер

Тестируется здесь ровно ОДНО: страница с кнопками против прямого перехода по адресу кнопки — не «смартлинк против чего-то». Адрес может быть любым: смарт-ссылка, Telegram, инстаграм, собственный сайт; движок читает его из кнопки.

ab_pct превращает вкл/выкл в живой эксперимент на включённом домене: N% посетителей получают прямой редирект (плечо B), остальные — обычную лендинг-воронку (плечо A). 0 = редирект всем (без A/B); 100 — то же самое, сказанное явно. Сплит липкий на посетителя и без кук, а входной клик несёт метку плеча, так что конверсии атрибутируются по плечу — вы измеряете, что конвертит лучше, вместо того чтобы коммититься на 100%. Строки доменов в GET /api/admin/domains отдают direct_redirect и direct_redirect_ab_pct.

Кнопки

Кнопки живут внутри сегмента. При управлении кнопками segment_id сегмента является path-параметром tier — так что buttons/{domain}/{segment_id} — это «кнопки, показываемые этой аудитории».

Список кнопок сегмента

curl https://app.tease.link/api/admin/buttons/links.creator.com/s_1a2b3c4d \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "domain": "links.creator.com",
  "tier": "s_1a2b3c4d",
  "items": [
    {
      "button_id": "main",
      "domain": "links.creator.com",
      "tier": "s_1a2b3c4d",
      "position": 0,
      "label": "Subscribe",
      "text_value": "Subscribe",
      "url": "https://example.com/offer",
      "icon": "heart.svg",
      "hidden": false,
      "match": null,
      "variants": null,
      "popup": null
    }
  ]
}

Создать кнопку

curl -X POST https://app.tease.link/api/admin/buttons/links.creator.com/s_1a2b3c4d \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text_value": "Subscribe",
    "url": "https://example.com/offer",
    "icon": "heart.svg"
  }'

Параметры

Редактирование и упорядочивание повторяют сегменты:

# Edit any subset of fields
curl -X PATCH https://app.tease.link/api/admin/buttons/links.creator.com/s_1a2b3c4d/main \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "text_value": "Join now" }'

# Reorder within the segment
curl -X PUT https://app.tease.link/api/admin/buttons/links.creator.com/s_1a2b3c4d/order \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "order": ["main", "secondary"] }'

# Delete
curl -X DELETE https://app.tease.link/api/admin/buttons/links.creator.com/s_1a2b3c4d/main \
  -H "Authorization: Bearer $TEASE_API_KEY"

Всплывающая подсказка

Любая кнопка может нести всплывающую подсказку — небольшую карточку с фото и текстом до 160 символов, которая выезжает под кнопкой после задержки. Клик по карточке нажимает саму кнопку. Подсказка показывается не более одного раза за просмотр страницы, а посетитель, закрывший её, не увидит её снова до конца сессии.

Настройка в два шага: загрузите фото (авто-обрезка в WebP-карточку 480×360), затем задайте объект popup на кнопке при создании или через PATCH.

# 1. Загрузить фото карточки (multipart, до 5 MB)
curl -X POST https://app.tease.link/api/admin/buttons/links.creator.com/s_1a2b3c4d/main/popup-photo \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -F "file=@teaser.jpg"

{ "filename": "popup_9f2c1a7b3d4e.webp", "url": "/notification/links.creator.com/popup_9f2c1a7b3d4e.webp" }

# 2. Привязать подсказку к кнопке
curl -X PATCH https://app.tease.link/api/admin/buttons/links.creator.com/s_1a2b3c4d/main \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "popup": {
      "enabled": true,
      "text": "Сегодняшний сет — скидка 50%, только 2 часа",
      "delay_ms": 4000,
      "photo": "popup_9f2c1a7b3d4e.webp"
    }
  }'

Поля подсказки

Объект popup заменяет сохранённую подсказку целиком. Повторная загрузка идентичных байтов фото идемпотентна (одинаковое содержимое → одинаковое имя файла), поэтому повторы безопасны.

Иконки

Каждая кнопка ссылается на иконку по имени файла. Библиотека иконок поставляется с ~290 встроенными иконками — бренд-марки плюс общие глифы, с поиском и категориями в пикере иконок панели — и держит рядом ваши собственные загрузки. Встроенные общие; всё, что вы загружаете или генерируете, приватно для вашего воркспейса.

# Список всего доступного (встроенные + ваши)
curl https://app.tease.link/api/admin/icons \
  -H "Authorization: Bearer $TEASE_API_KEY"

# Загрузить свой SVG (санитизируется, до 1 MB)
curl -X POST https://app.tease.link/api/admin/icons \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -F "file=@custom.svg"

Сгенерировать иконку через ИИ

Не нашли нужный глиф? POST /api/admin/icons/generate рисует новую иконку в фирменном стиле — белая на прозрачном фоне, так что она встаёт рядом со встроенными без швов — и сохраняет её прямо в вашу приватную библиотеку.

curl -X POST https://app.tease.link/api/admin/icons/generate \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "prompt": "бумажный самолётик", "style": "line" }'

{ "filename": "gen_7c2f91d3a4b5.svg", "builtin": false, "uploaded_at": 1752537600 }

Используйте возвращённое filename как icon кнопки. Генерация ограничена 6 в минуту (429 icon_gen_rate_limited); неудачная попытка возвращает 502 icon_ai_failed — просто повторите с переформулированным запросом.

Баннер-уведомление

Баннер — это push-подобная карточка для каждого домена (аватар, заголовок, текст и ссылка-призыв к действию), которая появляется на странице после небольшой задержки. На домен приходится один баннер — его можно редактировать руками, а можно вести из переиспользуемой библиотеки уведомлений (две и больше включённых карточек превращают его в креативный A/B-тест).

Прочитать и отредактировать

curl https://app.tease.link/api/admin/notification/links.creator.com \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "domain": "links.creator.com",
  "enabled": true,
  "avatar_filename": "av_9f.png",
  "sound_filename": null,
  "title": "New drop",
  "body": "Tap to see today's set",
  "link_text": "Open",
  "target_url": "https://example.com/offer",
  "delay_ms": 2500,
  "translations": {},
  "style": null,
  "preset_id": null,
  "assignment": null
}

PATCH принимает любое подмножество редактируемых полей:

curl -X PATCH https://app.tease.link/api/admin/notification/links.creator.com \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "enabled": true,
    "title": "New drop",
    "body": "Tap to see today’s set",
    "link_text": "Open",
    "target_url": "https://example.com/offer",
    "delay_ms": 2500
  }'

Параметры

Куда ведёт клик

У призыва к действию баннера два режима, переключаемые link_mode:

• «Смартлинк» ("", по умолчанию) — клик зеркалит главную кнопку сегмента, в который попал посетитель, следуя тому же tier-aware роутингу (и A/B-плечу), что и сами кнопки. URL для включения баннера в этом режиме не нужен; сохранённый target_url служит лишь последним фолбэком, когда у сегмента нет кнопки для зеркала.
• «Своя ссылка» ("manual") — баннер ведёт ровно туда, куда вы указали: target_url обязателен (включение без него вернёт 400 notification_incomplete) и побеждает зеркало сегмента.

Внешний вид

Вид баннера настраивается независимо от его содержимого: объект style в том же PATCH несёт ручки внешнего вида. Хранятся только заданные вами ключи; отправьте {}, чтобы сбросить баннер к стоковому виду. Текущее значение возвращается в поле style при чтении.

curl -X PATCH https://app.tease.link/api/admin/notification/links.creator.com \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "style": {
      "theme": "glass",
      "opacity": 0.9,
      "radius": 18,
      "avatar_shape": "circle",
      "position": "top",
      "accent": "#e0426e"
    }
  }'

Аватар и звук

Изображение аватара и необязательный звук уведомления загружаются как файлы и могут быть удалены:

# Upload an avatar (multipart)
curl -X POST https://app.tease.link/api/admin/notification/links.creator.com/avatar \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -F "file=@avatar.png"

# Remove the sound
curl -X DELETE https://app.tease.link/api/admin/notification/links.creator.com/sound \
  -H "Authorization: Bearer $TEASE_API_KEY"

Библиотека уведомлений и A/B

Вместо ручной правки каждого домена держите креативы баннера как переиспользуемые пресеты в библиотеке уведомлений и назначайте их на домены. В панели вкладка «Уведомление» — это стена карточек-пресетов с галочками: отмеченная карточка — это то, что домен показывает, две и больше галочек запускают креативный A/B-тест, а вес карточки задаёт её долю показов. Конкретный посетитель держится одного варианта (ротация sticky по подсети), так что тест остаётся чистым.

Пресет несёт креатив целиком — тексты, ссылку-призыв, задержку, переводы, плюс собственные мастер-файлы (аватар/звук), которые хранятся в notification/_preset_<id>/ и раздаются как /notification/_preset_<id>/<filename>. Когда пресет ставится на домен, мастера копируются в папку домена — боевой баннер никогда не ссылается на файл, которого нет.

# Список библиотеки
curl https://app.tease.link/api/admin/library/notifications \
  -H "Authorization: Bearer $TEASE_API_KEY"

# Сохранить текущий баннер домена в библиотеку — вместе с файлами
curl -X POST https://app.tease.link/api/admin/library/notifications/from-domain \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "links.creator.com", "name": "July drop" }'

from-domain снимает слепок черновика баннера домена в новый пресет вместе с файлами аватара/звука и штампует новый preset_id обратно на домен, так что карточка показывает свою привязку к библиотеке. Ошибки: 400 name_required / 400 notification_empty (нечего сохранять), 409 preset_name_taken, 404 domain_not_found.

Назначить пресеты на домен

Объект assignment в PATCH баннера — это API за галочками. Он заменяет сохранённое назначение целиком; { "items": [] } очищает его (назад к баннеру, отредактированному руками).

curl -X PATCH https://app.tease.link/api/admin/notification/links.creator.com \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "assignment": {
      "items": [
        { "preset_id": 7, "weight": 2, "enabled": true },
        { "preset_id": 9, "weight": 1, "enabled": true },
        { "preset_id": 4, "enabled": false }
      ]
    }
  }'

Каждый включённый пресет валидируется при сохранении: неизвестный id возвращает 404 preset_not_found, а пресет без текстов, без аватара или (в режиме «Своя ссылка») без ссылки — 400 preset_incomplete, так что сломанное плечо никогда молча не съест долю трафика. Первый включённый пресет штампуется в баннер домена (тексты, файлы и preset_id), а мастер-файлы всех включённых пресетов копируются в папку домена — назначение из одного пресета начинает показывать свой креатив сразу.

Аватары пресетов

У каждого пресета свой мастер-аватар, управляемый на самом пресете (multipart-изображение до 5 MB, центр-кроп в квадрат 192 px, WebP с content-hash именем):

# Загрузить / заменить мастер-аватар
curl -X POST https://app.tease.link/api/admin/library/notifications/7/avatar \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -F "file=@avatar.jpg"

# Удалить (привязанные домены тоже теряют его, и их баннеры выключаются)
curl -X DELETE https://app.tease.link/api/admin/library/notifications/7/avatar \
  -H "Authorization: Bearer $TEASE_API_KEY"

В панели аватар можно выбрать прямо из галереи фото или загрузить новое изображение — загруженное фото также сохраняется в галерею, так что в следующий раз оно под рукой.

Правка и применение пресетов

Правки через PATCH /api/admin/library/notifications/{preset_id} доезжают сразу: каждый домен, чьё назначение включает этот пресет, перештамповывается, а его черновик перепекается — фикс текста или аватара доходит до всех привязанных черновиков одним вызовом; в бой всё выходит по-прежнему явным /publish. POST /api/admin/library/notifications/{preset_id}/apply (тело { "domains": [...] }) штампует пресет на домены целиком: пишет назначение из одного пресета, материализует мастер-файлы в папку каждого домена и включает баннер только когда пресет полностью заполнен (все тексты, аватар и — в режиме «Своя ссылка» — ссылка).

Включение следует готовности пресета. При каждой перештамповке enabled привязанных доменов выводится из самого пресета: галочка в назначении — это намерение показывать, а баннер включается автоматически, как только пресет становится полным (все тексты, аватар и — в режиме «Своя ссылка» — ссылка) — например, когда в карточку наконец докинули аватар, — и честно выключается, когда пресет перестаёт быть полным.

Фон

У каждого домена есть фон, состоящий максимум из трёх частей: мобильное изображение, десктопное изображение и сплошной цвет холста, нарисованный за карточкой на десктопе. Изображения проходят через шаг загрузки и шаг редактирования; цвет холста — это один вызов.

Быстрый выбор: в карточке «ник модели» (вкладка «Кнопки») клик по аватару открывает библиотеку фонов — выберите один (→ один фон) или несколько (→ случайная ротация), не уходя из редактора кнопок. Загрузка и обрезка новых фонов остаётся во вкладке «Дизайн».

Загрузить и отредактировать изображение

bg/upload сохраняет оригинальное изображение для пары (domain, variant), где variant — это mobile или desktop. bg/edit применяет ваше состояние дизайна обрезки/трансформации и регенерирует отдаваемые варианты.

# 1. Upload the source image for the mobile background
curl -X POST "https://app.tease.link/api/admin/bg/upload?domain=links.creator.com&variant=mobile" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -F "file=@bg-mobile.jpg"

# 2. Commit the editor design state
curl -X POST "https://app.tease.link/api/admin/bg/edit?domain=links.creator.com&variant=mobile" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "designState": { } }'

const form = new FormData();
form.append('file', file); // a Blob/File of the image
await fetch(
  'https://app.tease.link/api/admin/bg/upload?domain=links.creator.com&variant=mobile',
  { method: 'POST', headers: { Authorization: `Bearer ${process.env.TEASE_API_KEY}` }, body: form },
);

Цвет холста

curl -X POST "https://app.tease.link/api/admin/bg/canvas-color?domain=links.creator.com" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "color": "#0d0604" }'

Внешний вид кнопок

Встроенные (платформенные) дизайны дают стиль кнопок на всём лендинге — форма, заливка, прозрачность, цвета, контраст подписи, типографика, цвета иконок, выравнивание и idle-анимация. Он проходит тот же цикл черновик → публикация, что и всё остальное, и задаётся через POST /api/admin/bg/ui, который несёт три независимые секции: buttons (эта), profile и gate. В панели они живут в хабе домена («Дизайн» / «Лендинг»), с живым предпросмотром каждой ручки.

Объект секции заменяет сохранённую секцию целиком (отправляйте полный нужный стиль); null сбрасывает её к стоковому виду. Хранятся только заданные вами ключи — всё опущенное сохраняет дефолт дизайна.

curl -X POST "https://app.tease.link/api/admin/bg/ui?domain=links.creator.com" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "buttons": {
      "shape": "pill",
      "fill": "solid",
      "opacity": 0.95,
      "color": "#e0426e",
      "text": "auto",
      "animation": "breathe",
      "anim_speed": "slow",
      "font": "unbounded",
      "align": "icon_left"
    }
  }'

# Назад к стоковому виду
curl -X POST "https://app.tease.link/api/admin/bg/ui?domain=links.creator.com" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "buttons": null }'

Полный рабочий пример — Style every button on the landing page; свободный холст, стопка тизеров, закреплённая панель, споттлайт и правила появления, которые живут рядом с этой секцией — на странице Landing-page builder.

Шрифты

Один и тот же брендовый пак из двенадцати начертаний питает каждую типографическую ручку страницы — подписи кнопок (buttons.font), карточку профиля (name_font / bio_font) и баннер-уведомление (style.font):

У латиница-only начертаний (satoshi, clashdisplay, bebas) нет кириллических глифов — кириллический текст в них автоматически падает в брендовый дефолт, так что русская подпись никогда не отрисуется «тофу». Id из снятого пака v1 продолжают читаться: они просто рендерятся дефолтом.

Смена font перерисовывает на сервере каждую подпись кнопок домена в новом начертании (подписи — заранее запечённые SVG); ответ возвращает их число в relabeled. Все шрифты самохостятся под свободными лицензиями и отдаются same-origin с вашего домена (/fonts/lf_<id>.woff2) — страница не делает ни одного стороннего запроса за шрифтами.

Карточка профиля

Тот же endpoint bg/ui настраивает карточку профиля над кнопками — шрифт и размер ника, строку статуса «Active now • Responds in 5 mins» и необязательное био со своими шрифтом и размером — через вторую секцию, profile. Только платформенные дизайны, тот же цикл черновик → публикация, та же замена секции целиком: отправляйте полную нужную секцию, либо { "profile": null } для сброса к стоковой карточке.

curl -X POST "https://app.tease.link/api/admin/bg/ui?domain=links.creator.com" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profile": {
      "name_font": "unbounded",
      "name_size": 1.2,
      "status_text": "Online now",
      "bio": "18+ • daily drops",
      "bio_font": "nunito",
      "bio_size": 0.9
    }
  }'

Контентный гейт 18+

Тот же endpoint bg/ui несёт необязательный гейт 18+ для чувствительного контента — шаг подтверждения перед страницей: либо полноэкранная обложка (опционально с размытием страницы за ней), либо компактный лист сверху. Посетитель подтверждает один раз на браузер, и его больше не спрашивают. Только платформенные дизайны, тот же цикл черновик → публикация.

curl -X POST "https://app.tease.link/api/admin/bg/ui?domain=links.creator.com" \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "gate": {
      "enabled": true,
      "mode": "cover",
      "blur": true,
      "title": "Только для взрослых",
      "text": "Эта страница содержит контент для взрослых.",
      "ok": "Мне есть 18",
      "leave": "Уйти",
      "leave_url": "https://google.com"
    }
  }'

Отправьте { "gate": null }, чтобы убрать гейт полностью.

Десктоп во весь экран, свободный холст, стопка, закреплённая панель и правила появления

bg/ui несёт ещё несколько секций помимо buttons/profile/gate — полные разборы живут в Landing-page builder (на английском, это интерфейсный раздел), здесь — сводка, чтобы вся поверхность bg/ui была в одном месте:

Языки и авто-перевод

Сегменты несут необязательную цель lang, а баннер-уведомление несёт карту translations, так что публичный текст может авто-переводиться по локалям. Объект translations индексируется по коду языка и хранит только публичные текстовые поля:

{
  "translations": {
    "es": { "title": "Nuevo drop", "body": "Toca para ver el set de hoy", "link_text": "Abrir" },
    "fr": { "title": "Nouveau drop", "link_text": "Ouvrir" }
  }
}

Поддерживаемые коды включают en, ru, pt, es, de, fr, it, nl, pl, tr, ar, hi, id, ja, ko, zh. Назначение призыва к действию никогда не является частью перевода — только видимые title, body и link_text.

QR-коды

Каждый домен может раздавать печатные QR-коды — флаер, наклейку, визитку, — которые ведут прямо на лендинг и считаются как любой другой источник трафика, живут вне цикла черновик/публикация. Создание, дизайн, скачивание, чтение воронки кода и переименование или отключение без потери уже напечатанного — см. QR codes (страница на английском, это техническая справка API).

Черновик → предпросмотр → публикация

Всё вышеперечисленное пишется в черновик. Ничто не идёт в бой, пока вы не опубликуете. Рекомендуемый цикл:

curl https://app.tease.link/api/admin/config \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "is_dirty": true,
  "dirty_domains": ["links.creator.com"],
  "draft": { "updated_at": 1751280600, "domains": {}, "segments": {}, "notifications": {}, "backgrounds": {} },
  "published": { "updated_at": 1751280000, "domains": {}, "segments": {}, "notifications": {}, "backgrounds": {} }
}

curl "https://app.tease.link/api/admin/preview-token?domain=links.creator.com&force_country=US&force_device=mobile" \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "token": "…",
  "public_url": "https://links.creator.com",
  "frame_path": "/preview-frame/"
}

Публикация и отмена

POST /api/admin/publish атомарно копирует черновик на боевую страницу. Без тела он публикует каждый грязный домен; передайте массив domains, чтобы опубликовать только некоторые.

# Publish everything that changed
curl -X POST https://app.tease.link/api/admin/publish \
  -H "Authorization: Bearer $TEASE_API_KEY"

# Publish only one domain
curl -X POST https://app.tease.link/api/admin/publish \
  -H "Authorization: Bearer $TEASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domains": ["links.creator.com"] }'

await fetch('https://app.tease.link/api/admin/publish', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.TEASE_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({ domains: ['links.creator.com'] }),
});

requests.post(
    "https://app.tease.link/api/admin/publish",
    headers={"Authorization": f"Bearer {os.environ['TEASE_API_KEY']}"},
    json={"domains": ["links.creator.com"]},
)

{ "ok": true, "bg_files_by_domain": {}, "domains": ["links.creator.com"] }

Публикация без изменений возвращает 400 nothing_to_publish. POST /api/admin/discard принимает такой же необязательный выбор domains и восстанавливает черновик из опубликованного; если откатывать нечего, он возвращает { "ok": true, "noop": true }.

Лента аудита

Каждое изменение выше журналируется. GET /api/admin/audit возвращает самые свежие записи (новые первыми), полезно для ленты активности или журнала изменений.

curl "https://app.tease.link/api/admin/audit?limit=50" \
  -H "Authorization: Bearer $TEASE_API_KEY"

{
  "items": [
    {
      "id": 9012,
      "ts": 1751280600,
      "actor": "owner",
      "action": "publish",
      "payload": "{\"tiers_updated\": true}"
    }
  ]
}

FAQ

Дальнейшие шаги