Документация · 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"] }'
Что дальше
- Smart Routing — разные landing'и для разных аудиторий
- Bitrix24 интеграция — клик → лид в CRM за 3 минуты
- SDK для Python — обёртка над REST с типизацией