Обзор API
REST API v1 для ссылок, аналитики, доменов и партнёрских операций: базовый адрес, виды ключей, области действия и модель white-label.
Обновлено 13 августа 2026 г.
Всё, что делает панель, умеет и API: создавать ссылки с таргетингом и split-тестами A/B, читать аналитику, подключать домены, управлять клиентами и тарифами. API — полноценная продуктовая поверхность: панель и API работают на одном коде и соблюдают одни и те же лимиты.
Базовый адрес
https://api.linkprofit.com/v1
Все запросы идут по HTTPS и в JSON. Ответы тоже в JSON, кроме изображения QR и выгрузки CSV. Интерактивный и всегда актуальный справочник находится по адресу /docs/api/reference и генерируется из тех же схем, по которым проверяется каждый запрос.
Два вида ключей
| Префикс ключа | Область действия | Где создаётся | Что открывает |
|---|---|---|---|
| lp_live_… | Рабочее пространство | Настройки рабочего пространства → ключи API | /links, /analytics, /domains, /workspace, /events, /webhooks |
| lpp_live_… | Партнёр | Настройки партнёра → ключи API | /partner/* и /webhooks |
Ключ рабочего пространства действует внутри одного клиентского рабочего пространства. Партнёрский ключ управляет партнёрским аккаунтом: клиентами, тарифами, доменами, платежами. Ключи несут области действия, ограничивающие возможности каждого ключа.
Версионирование
Версия v1 заморожена: поля только добавляются, но не переименовываются и не
удаляются. Несовместимые изменения вышли бы как /v2. Опирайтесь на
задокументированные поля и игнорируйте неизвестные.
White-label: предложение API вашим клиентам
Если вы ведёте white-label сервис ссылок, API — часть того, что вы перепродаёте:
- Ключи раздаёте вы. Каждый клиент создаёт ключи рабочего пространства в своей брендированной панели (Настройки → ключи API) — партнёрский ключ вы не передаёте никогда.
- Хост остаётся общим. В версии v1 весь трафик API идёт на
api.linkprofit.com— собственный домен API для каждого партнёра пока недоступен. Документируйте базовый адрес как «хост API вашего сервиса»; в ответах нет никакого брендинга LinkProfit. - Лимиты следуют вашим тарифам. Доступ к API — флаг возможности в тарифах, которые вы
продаёте (
api_access), а лимит частоты каждого ключа берётся из тарифа. Клиент на тарифе без доступа к API получит403 plan_restricted.
Готовую страницу, которую можно скопировать и адаптировать для собственной документации разработчика, смотрите в руководстве по white-label.
Быстрые указатели
- Быстрый старт — создать ссылку за две минуты.
- Аутентификация — ключи, области действия, ротация ключей.
- Пагинация — курсоры на каждом списочном эндпоинте.
- Ошибки — единый формат ошибки и все коды.
- Лимиты частоты — скользящее окно, заголовки, повторы.
- Webhook — подписанные доставки событий с повторами.