SDK API-referentie

De SDK API is wat apps aanroepen. Hij staat los van het dashboard en gebruikt de SDK-sleutel van een app, nooit je account.

Basis-URL

https://api.unolink.dev/v1

Authenticatie

Maak een sleutel in het dashboard onder het tabblad SDK van je app (Pro-abonnement en hoger), en stuur hem mee in een header:

X-Unolink-Key: ulk_…

De sleutel zit in je app, dus behandel hem als openbaar. Hij kan alleen gegevens opzoeken en rapporteren voor de ene app waar hij bij hoort, en je kunt hem op elk moment intrekken. Gebruik één sleutel per omgeving of build, zodat je ze apart kunt intrekken. De volledige sleutel wordt één keer getoond, als je hem maakt; Unolink slaat alleen een hash op.

Fouten

Fouten zijn JSON-problem details met een status, een title, een detail en, waar nuttig, een vaste code.

Status	Wanneer
`401`	De sleutel ontbreekt, is misvormd, onbekend of ingetrokken (`code`: `invalid_key`).
`403`	De eigenaar van de app heeft geen abonnement waar de SDK API bij hoort.
`404`	De resource bestaat niet, of hoort bij een andere app.
`429`	Te veel verzoeken vanaf één IP-adres. Probeer het later opnieuw, met backoff.

GET /v1/clicks/{clickId}

Zet een klik-ID uit de install referrer van Google Play om naar de bijbehorende link.

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 is null voor de hoofdlink van de app.
deepLink en params zijn de huidige waarden van de link, dus een wijziging na de klik bereikt de app nog steeds.
De UTM-tags zijn die op de link waarop is getikt.