Was ist die API Schnittstelle?
Mit der API-Schnittstelle von Affiliate-Dashboard.de können Sie automatisiert Ihre kompletten Statistiken abfragen. Dabei erfolgt der Zugriff ganz einfach per HTTP-Request und die Antworten werden wahlweise im HTML, JSON, CSV, XML oder XLS Format zurückgeliefert.
Wie kann ich die API nutzen?
API Key
Die Authentifizierung erfolgt über einen API-Key. Diesen können Sie in Ihren Account Einstellungen selbst generieren.
Key generieren
Der API Key ist quasi Ihr Benutzername für die Affiliate-Dashboard.de API und muss bei jedem Aufruf übermittelt werden.
IP Sperre (optional)
Für zusätzliche Sicherheit kann der Zugriff auf die API auf eine bestimmte IP-Adresse beschränkt werden. Falls erwünscht, tragen Sie einfach die entsprechende IP-Adresse in das dafür vorgesehene Feld ein. Wird keine IP-Adresse eingetragen, so ist der Zugriff auf die API von einer belibigen IP-Adresse möglich.
Wie rufe ich nun Daten über die API ab?
Nachdem Sie Ihren API Key generiert haben können Sie über folgende URL Ihre Statistiken abrufen:
https://affiliate-dashboard.de/api/{ihr-api-key}/{startDate}/{endDate}/{format}
Ersetzen Sie die entsprechenden Variablen in der URL mit Ihren Werten wie folgt:
- {ihr-api-key} - Ihr API-Key für den API-Zugriff
- {startDate} - Startdatum (YYYY-MM-DD), wird eingeschlossen
- {endDate} - Enddatum (YYYY-MM-DD), wird eingeschlossen
- {format} - Erwünschtes Ausgabeformat (html, json, csv, xml oder xls)
Beispielaufruf um die Statistiken eines Monats im CSV Format abzufragen:
https://affiliate-dashboard.de/api/v73klvzhfd739gbn549/2013-03-01/2013-03-31/csv
Beispielaufruf um die Statistiken für einen Tag im HTML Format abzufragen:
https://affiliate-dashboard.de/api/v73klvzhfd739gbn/2013-04-15/2013-04-15/html
Wie häufig kann ich eine API Abfrage starten?
Pro Account stehen Ihnen aktuell 1.000 API-Aufrufe pro Tag zur Verfügung. Jede Nacht um 24 Uhr wird der Counter zurückgesetzt.
Welchen Zeitraum kann ich abfragen?
Ein belibiger Zeitraum in dem die Statistiken bei uns gespeichert sind. Pro Aufruf ist es jedoch nur möglich ein Intervall von maximal 31 Tagen abzufragen.