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.

2. Erste Anfrage senden

Rufen Sie Get the linked team auf, um zu prüfen, ob der Token funktioniert. Senden Sie den Token im Header Authorization:

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:

{
  "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.

3. Nächste Schritte

Listen Sie Ihren Bestand mit List items auf und erfahren Sie unter Paginierung, wie Sie alle Seiten abrufen.
Erfassen Sie Bestandsänderungen mit Create a transaction – die Regeln finden Sie unter Transactions.
Lassen Sie sich mit Webhooks über Änderungen benachrichtigen, statt regelmäßig abzufragen.
Durchsuchen Sie alle Endpunkte in der API-Referenz.