> For the complete documentation index, see [llms.txt](https://wiki.packstack.de/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.packstack.de/api-schnittstelle/overview.md).

# Overview

### **Authentication** <a href="#id-48d3wrwifuz7" id="id-48d3wrwifuz7"></a>

{% hint style="danger" %}
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.
{% endhint %}

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

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

### **Endpoints and requests** <a href="#cd20b05k99o6" id="cd20b05k99o6"></a>

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

Alle REST-API-Endpunkte folgen diesem Muster:

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

### **Rate limits** <a href="#fs8q75gntoy7" id="fs8q75gntoy7"></a>

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** <a href="#xrx4rfx6wh57" id="xrx4rfx6wh57"></a>

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

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

### **Status and error codes** <a href="#wjxufr5smtgd" id="wjxufr5smtgd"></a>

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

#### **401 Unauthorized** <a href="#gfpd04ukcdv6" id="gfpd04ukcdv6"></a>

Der Kunde hat nicht die richtigen[ authentication](https://shopify.dev/docs/api/admin-rest#authentication) Daten.

#### **403 Forbidden** <a href="#id-1mq4n4q9vo48" id="id-1mq4n4q9vo48"></a>

Der Server verweigert die Antwort.

#### **404 Not Found** <a href="#xwgpgjxoa87d" id="xwgpgjxoa87d"></a>

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

#### **422 Unprocessable Entity or 400 Bad Request** <a href="#ic3uarmmv5gm" id="ic3uarmmv5gm"></a>

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** <a href="#it1p8h9wmllc" id="it1p8h9wmllc"></a>

Der Kunde hat die Tarifgrenze überschritten.

#### **5xx Errors** <a href="#id-8m6mhrgyo628" id="id-8m6mhrgyo628"></a>

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