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

Вебхуки для
коротких посилань

Створили посилання або хтось за ним перейшов, і на ваш 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.

Видаліть його в кабінеті, у розділі «Налаштування → Вебхуки». Якщо він знадобиться знову, додайте його ще раз.

Додайте перший вебхук

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