Référence de l’API SDK

L’API SDK est ce qu’appellent les apps. Elle est distincte du tableau de bord et utilise la clé SDK d’une app, jamais votre compte.

URL de base

https://api.unolink.dev/v1

Authentification

Créez une clé dans le tableau de bord, dans l’onglet SDK de votre app (forfait Pro et plus), et envoyez-la dans un en-tête :

X-Unolink-Key: ulk_…

La clé est intégrée à votre app, considérez-la donc comme publique. Elle ne peut rechercher et remonter des données que pour l’app à laquelle elle appartient, et vous pouvez la révoquer à tout moment. Utilisez une clé par environnement ou par build pour pouvoir les révoquer séparément. La clé complète n’est affichée qu’une fois, à sa création ; Unolink n’en stocke qu’un hash.

Erreurs

Les erreurs sont des problem details JSON avec un status, un title, un detail et, quand c’est utile, un code stable.

Statut	Quand
`401`	La clé est absente, mal formée, inconnue ou révoquée (`code` : `invalid_key`).
`403`	Le propriétaire de l’app n’a pas de forfait incluant l’API SDK.
`404`	La ressource n’existe pas, ou appartient à une autre app.
`429`	Trop de requêtes depuis une même adresse IP. Réessayez plus tard, avec un délai croissant (backoff).

GET /v1/clicks/{clickId}

Résout un identifiant de clic issu du referrer d’installation Google Play en son lien.

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 vaut null pour le lien principal de l’app.
deepLink et params sont les valeurs actuelles du lien, donc une modification faite après le clic atteint quand même l’app.
Les balises UTM sont celles du lien sur lequel on a appuyé.