DE
EN
ES
PL
PT-BR
PT-PT
RU
TR
VI
ZH-CN
Grundlegende API-Informationen
Einführung
Willkommen bei der SkinsBack-API.
Bei Fragen oder Anregungen kontaktieren Sie uns bitte.
Die Interaktion mit der SkinsBack-API erfolgt über den Endpunkt https://skinsback.com/api.php, an den Daten per POST-Anfrage übermittelt werden müssen.
Authentifizierung
Alle API-Anfragen erfordern eine Authentifizierung. Es stehen zwei Authentifizierungsoptionen zur Auswahl: über HTTP-Header oder über eine Signatur.
Authentifizierung über HTTP-Header (einfacher)
Es müssen zwei Parameter in den HTTP-Anforderungsheadern übergeben werden:
X-CLIENT-ID – die Client-ID aus den Projekteinstellungen
X-CLIENT-SECRET – das Client-Geheimnis aus den Projekteinstellungen
Authentifizierung per Signatur (komplexer)
Bei Verwendung der alten Authentifizierungsmethode müssen Sie zwei POST-Parameter übergeben:
shopid – die Client-ID aus den Projekteinstellungen.
sign – die Signatur, die gemäß den im Abschnitt Signaturgenerierung beschriebenen Regeln generiert wurde.
Antwortstruktur
Alle API-Methoden haben JSON-Antworten.
Erfolgreiche API-Aufrufe führen zu folgender Antwort:
{"status":"success", some data..}
Nicht erfolgreiche Anfragen enthalten error_code und error_message:
{"status":"error", "error_code": 5, "error_message":"some_error"}
Begrenzung der Anzahl der Anfragen
Unser System hat ein Limit von 500 Anfragen pro Minute an den Server. Wird dieses Limit überschritten, erfolgt eine temporäre Sperre und die API-Antwort lautet wie folgt:
{"status":"error", "error_code": -7, "error_message":"request_limit_reached"}