API-Überblick

Alles, was das Dashboard kann, kann auch die API: Links mit Targeting und A/B-Splits anlegen, Analytics auslesen, Domains verbinden, Kunden und Tarife verwalten. Die API ist eine vollwertige Produktoberfläche — Dashboard und API führen denselben Code aus und erzwingen dieselben Limits.

Basis-URL

https://api.linkprofit.com/v1

Alle Anfragen laufen über HTTPS und JSON. Die Antworten sind JSON, ausgenommen das QR-Bild und der CSV-Export. Die interaktive, stets aktuelle Referenz liegt unter /docs/api/reference und wird aus denselben Schemas erzeugt, die jede Anfrage validieren.

Zwei Arten von Schlüsseln

| Schlüsselpräfix | Geltungsbereich | Angelegt in | Öffnet | |---|---|---|---| | lp_live_… | Workspace | Workspace-Einstellungen → API-Schlüssel | /links, /analytics, /domains, /workspace, /events, /webhooks | | lpp_live_… | Partner | Partner-Einstellungen → API-Schlüssel | /partner/* und /webhooks |

Ein Workspace-Schlüssel wirkt innerhalb eines Kunden-Workspace. Ein Partner-Schlüssel verwaltet das Partnerkonto: Kunden, Tarife, Domains, Zahlungen. Schlüssel tragen Berechtigungen, die begrenzen, was ein Schlüssel darf.

Versionierung

v1 ist eingefroren: Felder kommen nur hinzu, sie werden nie umbenannt oder entfernt. Breaking Changes kämen als /v2. Bauen Sie gegen die dokumentierten Felder und ignorieren Sie unbekannte.

White-Label: die API Ihren Kunden anbieten

Wenn Sie einen Linkdienst in eigener Marke betreiben, gehört die API zu dem, was Sie weiterverkaufen:

• Die Schlüssel vergeben Sie. Jeder Kunde legt Workspace-Schlüssel in seinem eigenen gebrandeten Dashboard an (Einstellungen → API-Schlüssel) — Ihren Partner-Schlüssel geben Sie nie weiter.
• Der Host bleibt geteilt. In v1 geht der gesamte API-Traffic an api.linkprofit.com — eine eigene API-Domain je Partner gibt es noch nicht. Dokumentieren Sie die Basis-URL als „den API-Host Ihres Dienstes“; die Antworten tragen keinerlei LinkProfit-Branding.
• Die Limits folgen Ihren Tarifen. API-Zugriff ist ein Schalter an den Tarifen, die Sie verkaufen (api_access), und das Rate-Limit eines Schlüssels kommt aus dem Tarif. Ein Kunde in einem Tarif ohne API-Zugriff erhält 403 plan_restricted.

Im White-Label-Leitfaden finden Sie eine fertige Seite zum Kopieren, die Sie für Ihre eigene Entwicklerdokumentation anpassen können.

Schnelle Wegweiser

• Schnellstart — in zwei Minuten einen Link anlegen.
• Authentifizierung — Schlüssel, Berechtigungen, Schlüsselwechsel.
• Paginierung — Cursor an jedem Listen-Endpunkt.
• Fehler — das eine Fehlerformat und jeder Code.
• Rate-Limits — gleitendes Fenster, Header, Wiederholungen.
• Webhooks — signierte Ereigniszustellungen mit Wiederholungen.