Llink-platform
Документация · API · Гайды

Документация link-platform

Гайды, API-референс, рецепты для маркетологов и разработчиков. Всё на русском, без воды.

Быстрый старт

Создадим первую ссылку через API за 5 минут. После прохождения вы будете уметь генерировать short-link, отслеживать клики и обрабатывать конверсии.

Что нужно
Аккаунт на link-platform (бесплатный тариф достаточно) и любой HTTP-клиент: curl, Postman или ваша CRM.

Шаг 1 — Получите API-ключ

После регистрации перейдите в Настройки → API и нажмите «Создать ключ». Скопируйте его — больше он показан не будет.

# Сохраните ключ в переменную окружения для удобства
export LP_API_KEY="lp_live_a8c4f6...xyz"
Безопасность
Не коммитьте ключи в публичный git. Используйте переменные окружения или Vault.

Шаг 2 — Создайте первую ссылку

Отправьте POST-запрос на /api/v1/links:

curl -X POST https://api.link-platform.ru/v1/links \
  -H "Authorization: Bearer $LP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://example.com/promo",
    "slug": "promo-2026"
  }'

В ответ получите объект ссылки:

{
  "id": "lnk_a8c4f6",
  "short_url": "https://lnk.pl/promo-2026",
  "target_url": "https://example.com/promo",
  "created_at": "2026-05-19T08:30:12Z",
  "clicks": 0
}

Шаг 3 — Отслеживайте клики

Каждый клик автоматически попадает в аналитику. Получите метрики:

curl https://api.link-platform.ru/v1/links/lnk_a8c4f6/stats \
  -H "Authorization: Bearer $LP_API_KEY"

Ответ содержит подробную разбивку по дням, гео, устройствам и источникам:

{
  "total_clicks": 1247,
  "unique_visitors": 893,
  "by_country": { "RU": 1102, "BY": 98, "KZ": 47 },
  "by_device": { "mobile": 812, "desktop": 435 }
}

Шаг 4 — Настройте webhook (опционально)

Получайте уведомления о каждом клике или конверсии. Создайте подписку:

curl -X POST https://api.link-platform.ru/v1/webhooks \
  -H "Authorization: Bearer $LP_API_KEY" \
  -d '{
    "url": "https://your-app.ru/lp-webhook",
    "events": ["click", "conversion"]
  }'
Что дальше