API: Verbindung und Datenabruf
AffiliateCore integrieren: Zugriffstoken, Berechtigungen, Abfragen, Seitennavigation, Konversionsdatensätze und Fehlerbehandlung.
API v1 wurde am 10. Oktober 2026 freigeschaltet. Lesen Sie Daten Ihrer eigenen Rolle und Ihres Projekts. Berechtigte Kontoinhaber erstellen ein Token im Konto; der Link zur Anleitung gewährt keine Rechte.
Datenumfang
Die API dient dem Lesen eigener Daten. Publisher erhalten den verfügbaren Angebotskatalog sowie eigene Kampagnen und Konversionen. Werbetreibende erhalten ihr Projekt und dessen Angebote, Kampagnen und Konversionen. Die Statistik zählt Konversionsdatensätze nach Tag und Status, keine Besucher, Rohklicks, Umsätze oder Guthaben. Angebote anlegen, Kampagnen aktivieren, einzahlen oder auszahlen ist nicht vorgesehen.
Verbindung einrichten
- Mit der gewünschten Rolle anmelden, E-Mail bestätigen und Kontoanforderungen erfüllen.
- Konto und Einstellungen → API-Zugang öffnen. Werbetreibende müssen Eigentümer des ausgewählten Projekts sein; Manager- oder Finanzrechte allein reichen nicht.
- Integration benennen, nur benötigte Rechte wählen und das aktuelle Passwort bestätigen. Für eine Publisher-Zusammenfassung genügt
publisher:analytics:read. - Token sofort sicher speichern: Es wird nicht erneut angezeigt. Laufzeit 30 Tage, höchstens fünf aktive Token pro Nutzer/Kontext. Andere Rollen und Projekte benötigen eigene Token.
- Nur per HTTPS im Header
Authorization: Bearersenden, niemals in URLs, öffentlichem JavaScript, Nachrichten oder Logs. Bei aktivem MFA ist die Ausgabe in dieser Version gesperrt. Schutz nicht abschalten; Support kontaktieren.
Anfrage und Antwort
Das Lehrbeispiel ist für Publisher. YOUR_TOKEN ist ein Platzhalter. Werbetreibende verwenden ihre numerische Projekt-ID, nicht den Slug. Rechte gelten unabhängig: Analyserechte erlauben keinen Export einzelner Konversionen.
GET /api/v1/publisher/analytics?from=2026-10-01&to=2026-10-07
Host: affiliate-core.com
Authorization: Bearer YOUR_TOKEN
Accept: application/json
| GET | Scope |
|---|---|
/api/v1/publisher/offers |
publisher:offers:read |
/api/v1/publisher/campaigns |
publisher:campaigns:read |
/api/v1/publisher/conversions |
publisher:conversions:read |
/api/v1/publisher/analytics |
publisher:analytics:read |
/api/v1/advertiser/{id}/company |
advertiser:company:read |
/api/v1/advertiser/{id}/offers |
advertiser:offers:read |
/api/v1/advertiser/{id}/campaigns |
advertiser:campaigns:read |
/api/v1/advertiser/{id}/conversions |
advertiser:conversions:read |
/api/v1/advertiser/{id}/analytics |
advertiser:analytics:read |
Seiten und Zeitraum
Listen liefern data und meta.next_cursor. per_page ist standardmäßig 25, zulässig sind 1–100. Den erhaltenen cursor mit identischen Filtern und gleicher Seitengröße senden, bis next_cursor gleich null ist. Cursor nicht selbst erstellen oder entschlüsseln. Einzelobjekte und Analysen stehen in data.
from und to für Konversionen/Analysen verwenden YYYY-MM-DD in UTC, einschließlich beider Tage. Maximal und standardmäßig 30 Kalendertage, keine zukünftigen Daten. Maßgeblich ist event_at. 1.–7. Oktober sind sieben Tage; 10. September–9. Oktober sind 30. Längere Historien aufteilen.
Angebote: status, payout_model; Kampagnen: status, offer_id; Konversionen: status, event_type, offer_id, campaign_id, from, to. Analysen akzeptieren die letzten fünf ohne status. Detail und company erlauben keine Query-Parameter. Unbekannte Parameter ergeben 422. Eine erfolgreiche Null bedeutet keine Datensätze; 503 bedeutet nicht null Konversionen.
Fehler und Pflege
401: Token/Laufzeit prüfen; 403: Rechte/Kontostatus; 404: Objekt fehlt, ist unzugänglich oder API deaktiviert; 405: Methode nicht unterstützt; 422: Parameter; 429: Retry-After abwarten; 503: später mit wachsender Pause wiederholen. 401/403 nicht endlos wiederholen.
60 Anfragen pro Minute und Nutzer über alle Token; zusätzlich 10 Analysen pro Minute und Nutzer/Kontext. Bei Rotation neues Token erstellen, Integration umstellen und altes widerrufen. Passwortwechsel macht bisherige Token ungültig. Kompromittierte Token sofort widerrufen.
Mit kleinem Zeitraum beginnen und Datensätze/Status im selben UTC-Fenster mit dem Konto vergleichen. Letzte erfolgreiche Synchronisierung und Fehler getrennt speichern. Dem Support nur Pfad ohne Geheimnisse, Zeit, Antwortcode und anonymisierte Beschreibung senden.