Вебхуки для
коротких посилань
Створили посилання або хтось за ним перейшов, і на ваш 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.
Видаліть його в кабінеті, у розділі «Налаштування → Вебхуки». Якщо він знадобиться знову, додайте його ще раз.