SDK-API-Referenz

Die SDK-API ist das, was Apps aufrufen. Sie ist vom Dashboard getrennt und nutzt den SDK-Schlüssel einer App, nie dein Konto.

Basis-URL

https://api.unolink.dev/v1

Authentifizierung

Erstelle im Dashboard im Tab SDK deiner App einen Schlüssel (ab dem Pro-Tarif) und sende ihn in einem Header:

X-Unolink-Key: ulk_…

Der Schlüssel steckt in deiner App, behandle ihn also als öffentlich. Er kann nur Daten für die eine App abfragen und melden, zu der er gehört, und du kannst ihn jederzeit widerrufen. Nutze einen Schlüssel pro Umgebung oder Build, damit du sie einzeln widerrufen kannst. Der vollständige Schlüssel wird einmal angezeigt, wenn du ihn erstellst; Unolink speichert nur einen Hash.

Fehler

Fehler sind JSON-Problem Details mit einem status, einem title, einem detail und, wo sinnvoll, einem stabilen code.

Status	Wann
`401`	Der Schlüssel fehlt, ist fehlerhaft, unbekannt oder widerrufen (`code`: `invalid_key`).
`403`	Der Inhaber der App hat keinen Tarif, der die SDK-API enthält.
`404`	Die Ressource existiert nicht oder gehört zu einer anderen App.
`429`	Zu viele Anfragen von einer IP-Adresse. Versuch es später erneut, mit Backoff.

GET /v1/clicks/{clickId}

Löst eine Klick-ID aus dem Install-Referrer von Google Play zu ihrem Link auf.

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 ist null beim Hauptlink der App.
deepLink und params sind die aktuellen Werte des Links, eine Änderung nach dem Klick erreicht die App also trotzdem.
Die UTM-Tags sind die des Links, auf den getippt wurde.