Справочник SDK API

SDK API — это то, к чему обращаются приложения. Он отделён от панели и использует ключ SDK приложения, а не ваш аккаунт.

Базовый URL

https://api.unolink.dev/v1

Аутентификация

Создайте ключ в панели на вкладке SDK вашего приложения (тариф Pro и выше) и отправляйте его в заголовке:

X-Unolink-Key: ulk_…

Ключ находится внутри вашего приложения, поэтому считайте его публичным. С ним можно только искать и отправлять данные того единственного приложения, которому он принадлежит, и вы можете отозвать его в любой момент. Используйте отдельный ключ для каждого окружения или сборки, чтобы отзывать их по отдельности. Полный ключ показывается один раз, при создании; Unolink хранит только его хеш.

Ошибки

Ошибки возвращаются в формате JSON problem details с полями status, title, detail и, где это полезно, неизменным code.

Статус	Когда
`401`	Ключ отсутствует, имеет неверный формат, неизвестен или отозван (`code`: `invalid_key`).
`403`	Владелец приложения не на тарифе, который включает SDK API.
`404`	Ресурс не существует или принадлежит другому приложению.
`429`	Слишком много запросов с одного IP-адреса. Повторите позже, с нарастающей паузой.

GET /v1/clicks/{clickId}

Находит ссылку по ID клика из реферера установки Google Play.

curl https://api.unolink.dev/v1/clicks/clk_01JA9Q3F6Z8W2K4N7R5T1V0X3Y -H "X-Unolink-Key: ulk_…"

{
  "clickId": "clk_01JA9Q3F6Z8W2K4N7R5T1V0X3Y",
  "occurredAt": "2026-10-08T09:41:12.512+00:00",
  "link": { "slug": "tiktok", "name": "TikTok", "isDefault": false },
  "deepLink": "/promo/3for2",
  "params": { "offer": "3for2" },
  "utm": { "source": "tiktok", "medium": "paid", "campaign": "launch", "term": null, "content": "ad7" }
}

link.slug равен null для основной ссылки приложения.
deepLink и params — это текущие значения ссылки, поэтому изменение, сделанное после клика, всё равно дойдёт до приложения.
UTM-метки — те, что стоят на ссылке, по которой нажали.