Для разработчиков · бета, бесплатно для всех

Вебхуки для
коротких ссылок

Создали ссылку или кто-то по ней перешёл, и на ваш URL уходит POST с данными события. Запрос обычный, без авторизации.

Подключение

Как добавить вебхук

Один вебхук имеет одно событие и один URL. Вы можете добавить несколько вебхуков. Создавайте ссылки на главной, в кабинете или через API.

Добавить вебхук

События

Когда приходит запрос

link.created

Вы создали короткую ссылку. В payload лежат все её поля.

link.visited

Кто-то перешёл по ссылке. В payload лежат данные посетителя.

Формат

Что придёт на ваш URL

POST в формате form-urlencoded, без авторизации. Полей четыре. Данные события лежат JSON-строкой в data[payload].

event          link.created или link.visited
ts             время события, Unix timestamp
data[id]       id ссылки (link.created) или перехода (link.visited)
data[payload]  JSON-строка с полями ссылки или перехода

Пример payload для link.created

{
  "id": 126,
  "destination_url": "https://example.com/page",
  "default_short_url": "https://lnk.ua/XHxu0jKaP",
  "url_key": "XHxu0jKaP",
  "created_at": "2026-11-16T13:57:30.000000Z"
}

Пример payload для link.visited

{
  "id": 106,
  "short_url_id": 126,
  "visited_at": "2026-11-16T13:57:30.000000Z",
  "ip_address": "203.0.113.7",
  "operating_system": "OS X",
  "browser": "Chrome",
  "browser_version": "120",
  "device_type": "desktop",
  "referer_url": "https://t.me/"
}

Доставка

Ответьте кодом 200

После ответа HTTP 200 запрос считается доставленным. На любой другой ответ мы повторим запрос ещё несколько раз.

Отвечайте сразу

link.visited приходит на каждый переход, включая ботов. На ссылке с большим трафиком запросов будет много, поэтому обработку делайте после ответа.

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

Вебхуки входят в PRO. Пока идёт бета, они бесплатны для всех. Цены смотрите в тарифах.

Подписи у запроса нет. Добавьте секрет в URL вебхука, например https://example.com/hook?secret=abc123, и сверяйте его на своём сервере. Запрос с другим секретом отклоняйте.

В form-urlencoded все значения становятся строками, а пустые теряются. В JSON-строке число остаётся числом, а null остаётся null. Разберите строку как JSON, в PHP это json_decode.

Да, link.visited приходит на каждый переход, ботов мы не отсеиваем. Если они мешают, отсеивайте их у себя: в payload есть IP, браузер и тип устройства.

Да. Добавьте несколько вебхуков с этим событием и дайте каждому свой URL.

Удалите его в кабинете, в разделе «Настройки → Вебхуки». Если он понадобится снова, добавьте его заново.

Добавьте первый вебхук

Добавить вебхук