Environments

Es gibt zwei Umgebungen. Sie sind vollständig getrennt: eigene Datenbank, eigene Firmen, eigene Benutzer, eigene Token.

Umgebung	Basis-URL	Wofür
Demo	https://demo.aircargobook.com	Entwickeln, Testen, Abnahme
Produktion	https://www.aircargobook.com	Echte Frachten und Buchungen

Die Regel

Entwickle und teste ausschließlich gegen Demo. Eine Fracht, die du in der Produktion anlegst, ist echt: sie wird für Anbieter sichtbar, löst Benachrichtigungen aus und kann zu einem verbindlichen Auftrag führen. Es gibt keinen Sandbox-Modus innerhalb der Produktion.

Token sind nicht umgebungsübergreifend

Ein Token aus der Demo funktioniert in der Produktion nicht — und umgekehrt. Du bekommst 401, ohne weiteren Hinweis darauf, dass es die falsche Umgebung war.

Genauso gilt: IDs sind nicht umgebungsübergreifend. Fracht 12345 in der Demo ist eine andere Fracht als 12345 in der Produktion. Firmen-IDs, Raten-IDs und Angebots-IDs ebenfalls. Übernimm keine IDs aus deinen Tests in die Produktion.

Konfiguration in deinem Client

Mach die Basis-URL und den Token zu Konfigurationswerten, nicht zu Konstanten im Code:

# .env (Demo)
ACB_BASE_URL=https://demo.aircargobook.com
ACB_TOKEN=dein-demo-token

# .env (Produktion)
ACB_BASE_URL=https://www.aircargobook.com
ACB_TOKEN=dein-produktions-token

const res = await fetch(`${process.env.ACB_BASE_URL}/freights/add.json`, {
  method: 'POST',
  headers: {
    'Authorization': `ApplePass ${process.env.ACB_TOKEN}`,
    'Content-Type': 'application/json',
    'User-Agent': 'MyApplication / 1.0.0',
  },
  body: JSON.stringify({ /* … */ }),
})

Damit ist der Wechsel eine Konfigurationsänderung und kein Deploy.

Zugang bekommen

Für beide Umgebungen brauchst du einen Benutzer, der einer Firma zugeordnet ist — ohne Firmenzuordnung kannst du keine Frachten anlegen. Beides richten wir ein: support@aircargobook.com.

Wie du daraus einen Token machst, steht unter Authentifizierung.