> For the complete documentation index, see [llms.txt](https://www.boxhero.io/docs/llms.txt). Every page is available as Markdown by appending `.md` to its URL; this page is [Markdown](https://www.boxhero.io/docs/de/developers/api/quickstart.md).

# Schnellstart

> Erstellen Sie einen API-Token und senden Sie Ihre erste Anfrage an die BoxHero API.

Diese Anleitung führt Sie vom fehlenden Token bis zu Ihrem ersten erfolgreichen API-Aufruf.

## 1. API-Token erstellen

Öffnen Sie in der Desktop-Web-App das Team, das Sie verbinden möchten, und gehen Sie zu `Einstellungen` > `Integrationen`. Erstellen Sie einen neuen API-Token und kopieren Sie ihn.

![](https://assets.boxhero.io/docs/images/e6bbc8fa4eab21ec0f9ebe74893cd3a6e0c6a5d4d178ae02478ef99adbe4c4cd-2214x1431.jpg)

> **Caution**
>
> **Hinweis**: Ein Token ist an das Team gebunden, in dem er erstellt wurde, und gewährt über die API vollen Zugriff auf die Daten dieses Teams. Bewahren Sie ihn auf Ihrem Server auf – niemals in einer mobilen App, in Browser-Code oder in einem öffentlichen Repository.

## 2. Erste Anfrage senden

Rufen Sie [Get the linked team](https://www.boxhero.io/docs/de/developers/api/reference/teams/get-linked-team) auf, um zu prüfen, ob der Token funktioniert. Senden Sie den Token im Header `Authorization`:

```bash
curl https://rest.boxhero-app.com/v1/teams/linked \
  -H "Authorization: Bearer $BOXHERO_API_TOKEN"
```

Die Antwort beschreibt das Team, zu dem der Token gehört:

```json
{
  "id": 149058,
  "name": "Acme Retail",
  "mode": 2,
  "currency_symbol": "$",
  "currency_code": "USD",
  "price_decimal_places": 2,
  "memo": null
}
```

Erhalten Sie stattdessen `401`, fehlt der Token oder wurde unvollständig kopiert. Das Fehlerformat finden Sie unter [Fehler](https://www.boxhero.io/docs/de/developers/api/errors).

> **Note**
>
> Die meisten Endpunkte funktionieren nur für Teams, die ihren Bestand nach [Standort](https://www.boxhero.io/docs/de/concepts/locations) verwalten. Für andere Teams geben sie einen Fehler vom Typ `/errors/invalid-team-mode` zurück. Bei einem Standort-Team ist `mode` in der obigen Antwort auf `2` gesetzt.

## 3. Nächste Schritte

- Listen Sie Ihren Bestand mit [List items](https://www.boxhero.io/docs/de/developers/api/reference/items/list-items) auf und erfahren Sie unter [Paginierung](https://www.boxhero.io/docs/de/developers/api/pagination), wie Sie alle Seiten abrufen.
- Erfassen Sie Bestandsänderungen mit [Create a transaction](https://www.boxhero.io/docs/de/developers/api/reference/transactions/create-transaction) – die Regeln finden Sie unter [Transactions](https://www.boxhero.io/docs/de/developers/api/reference/transactions).
- Lassen Sie sich mit [Webhooks](https://www.boxhero.io/docs/de/developers/webhooks/overview) über Änderungen benachrichtigen, statt regelmäßig abzufragen.
- Durchsuchen Sie alle Endpunkte in der [API-Referenz](https://www.boxhero.io/docs/de/developers/api/reference).