# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://wiki.packstack.de/api-schnittstelle/overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
