Overview

Authentication

Alle REST API Abfragen erfordern ein gültiges Packstack-Zugangs-Token. Füge dein Token als X-AUTH-TOKEN Header bei allen API-Anfragen. Du kannst ein Zugriffstoken von deinem Packstack-Kundenbetreuer anfordern.

Eine Anwendung kann authentifizierte Anfragen an die REST API unter Verwendung der API-Zugangs-Tokens, die bei der Erstanmeldung generiert werden.

 curl -X GET \ https://{shop}.my.packstack.de/api/tracking/estimate \
  -H 'Content-Type: application/json' \
  -H 'X-AUTH-Token: {token}'

Endpoints and requests

REST-API-Endpunkte sind nach Ressourcentyp geordnet. Je nach den Anforderungen Ihrer Anwendung müssen Sie verschiedene Endpunkte verwenden.

Alle REST-API-Endpunkte folgen diesem Muster:

https://{store_name}.my.packstack.de/api/{resource}

Rate limits

Die REST-API unterstützt ein Limit von 40 Anfragen pro App und Store pro Minute. Dieses Kontingent wird mit einer Rate von 2 Anfragen pro Sekunde aufgefüllt.

Usage limitations

Die REST Admin API unterstützt ein Limit von 40 Anfragen pro App und Store pro Minute.

Wird dieses Limit überschritten, gibt die API ein 429 Too Many Requests error.

Status and error codes

Alle API-Abfragen geben HTTP-Statuscodes zurück, die dir mehr über die Antwort verraten können.

401 Unauthorized

Der Kunde hat nicht die richtigen authentication Daten.

403 Forbidden

Der Server verweigert die Antwort.

404 Not Found

Die angeforderte Ressource wurde nicht gefunden, könnte aber in Zukunft wieder verfügbar sein.

422 Unprocessable Entity or 400 Bad Request

Der Anfragekörper enthält semantische Fehler. Dies ist in der Regel auf eine falsche Formatierung, das Auslassen von Pflichtfeldern oder logische Fehler zurückzuführen, wie z. B. die Einleitung einer Kaufabwicklung für ein Produkt, das nicht auf Lager ist.

429 Too Many Requests

Der Kunde hat die Tarifgrenze überschritten.

5xx Errors

Es ist ein interner Fehler in Packstack Connect aufgetreten oder der Upstream Shopify Server ist nicht verfügbar.