Riferimento API dell’SDK

L’API dell’SDK è quella che chiamano le app. È separata dalla dashboard e usa la chiave SDK di un’app, mai il tuo account.

URL di base

https://api.unolink.dev/v1

Autenticazione

Crea una chiave nella dashboard, nella scheda SDK della tua app (dal piano Pro in su), e inviala in un header:

X-Unolink-Key: ulk_…

La chiave va dentro la tua app, quindi considerala pubblica. Può solo cercare e inviare dati per l’unica app a cui appartiene, e puoi revocarla in qualsiasi momento. Usa una chiave per ambiente o per build, così puoi revocarle separatamente. La chiave completa viene mostrata una sola volta, quando la crei; Unolink ne conserva solo un hash.

Errori

Gli errori sono problem details in JSON con uno status, un title, un detail e, dove utile, un code stabile.

Status	Quando
`401`	La chiave manca, è malformata, sconosciuta o revocata (`code`: `invalid_key`).
`403`	Il proprietario dell’app non ha un piano che include l’API dell’SDK.
`404`	La risorsa non esiste, o appartiene a un’altra app.
`429`	Troppe richieste da un solo indirizzo IP. Riprova più tardi, con backoff.

GET /v1/clicks/{clickId}

Risolve un ID del clic preso dal referrer di installazione di Google Play nel suo 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 è null per il link principale dell’app.
deepLink e params sono i valori attuali del link, quindi una modifica fatta dopo il clic arriva comunque all’app.
I tag UTM sono quelli del link che è stato toccato.