API

AffKeeper-Links programmatisch über eine einfache JSON-API erstellen und verwalten.

AffKeeper bietet eine JSON-API, mit der Sie Links aus eigenem Code oder eigenen Tools erstellen und verwalten können. Es ist dieselbe API, die auch das WordPress-Plugin verwendet.

Interaktive Referenz

Die vollständige, stets aktuelle Endpunkt-Referenz (Schemata, Parameter, Ausprobieren) wird aus dem laufenden Dienst generiert:

Interaktive Docs: https://affkeeper.com/api/reference
OpenAPI-Schema: https://affkeeper.com/openapi.json

Authentifizierung

Die API wird mit einem Bearer-API-Schlüssel authentifiziert.

Gehen Sie im Panel zu Einstellungen → API-Schlüssel und erstellen Sie einen Schlüssel. Kopieren Sie ihn — er wird nur einmal angezeigt.
Senden Sie ihn bei jeder Anfrage im Authorization-Header mit:
```
Authorization: Bearer YOUR_API_KEY
```

Halten Sie den Schlüssel geheim. Sie können einen Schlüssel im selben Bildschirm jederzeit widerrufen oder löschen; ein widerrufener Schlüssel funktioniert sofort nicht mehr.

Basis-URL

https://affkeeper.com/api

Beispiel

Einen Link erstellen (das exakte Request-/Response-Schema finden Sie in der interaktiven Referenz):

curl -X POST https://affkeeper.com/api/v1/links \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://example.com/product", "domain_id": null}'

Rate-Limits & Fehler

Anfragen sind pro IP ratenbegrenzt; wohlerzogene Clients erreichen das Limit nicht.
Fehler liefern einen JSON-Body mit einer error-Meldung und einem passenden HTTP-Status (400 ungültige Eingabe, 401 falscher/fehlender Schlüssel, 429 zu viele Anfragen).