Quickstart
Von null zur ausgeschriebenen Fracht in vier Requests. Ein Script, das du kopieren und laufen lassen kannst.
Loslegen
Erscheinungsbild
API-Dokumentation
Frachten anlegen, Raten suchen, Angebote abgeben — programmatisch
Skip to content
Wenn du drei Minuten hast
Diese fünf Punkte ersparen dir die meisten Rückfragen:
1. .json an jede URL. Ohne die Endung bekommst du die HTML-Oberfläche zurück — mit HTTP 200. Häufigste Fehlerursache beim ersten Integrieren.
✗ POST /freights/add → 200, text/html
✓ POST /freights/add.json → 200, application/json2. Wo die Nutzdaten liegen, wechselt. Beim Anlegen einer Fracht liegt sie flach in data (data.id), beim Abrufen unter data.route. Siehe Konventionen.
3. Eine neue Fracht ist ein Entwurf. POST /freights/add.json erzeugt status: "draft" — unsichtbar für Anbieter. Ausgeschrieben wird sie erst durch einen zweiten Request (action: "publish"). Das ist der Schritt, der am häufigsten fehlt.
4. Für die Anzeige gibt es fertige Felder. Neben den Rohwerten liefert jede Fracht formatierte f_-Varianten — f_eta statt eta, f_from statt from + from_country. Direkt verwendbar, in der Sprache deines Benutzers.
5. Entwickle gegen Demo. https://demo.aircargobook.com. In der Produktion sind Frachten echt: sichtbar für Anbieter, mit Benachrichtigungen, potenziell verbindlich. Token und IDs gelten jeweils nur in ihrer eigenen Umgebung.
Was du hier findest
| Ich will … | Hier |
|---|---|
| einfach mal etwas laufen sehen | Quickstart |
| einen Token bekommen und richtig nutzen | Authentifizierung |
| wissen, welche Umgebung ich ansprechen soll | Environments |
| eine Fracht anlegen und ausschreiben | Fracht anlegen |
| Angebote zu meiner Fracht abrufen | Fracht anlegen → Angebote lesen |
| wissen, welche Felder ein Endpunkt akzeptiert | API-Referenz |
| Trucking-Raten suchen | API-Referenz: Pricing |
| die Spec in Postman laden | /openapi.json |
Eine Bitte
Schick uns einen User-Agent im Format Softwarename / Version, wenn dein HTTP-Client das zulässt:
User-Agent: MyApplication / 1.0.0Technisch nicht nötig — aber bei einer Störung ist das der Unterschied zwischen „wir wissen, wen wir anrufen" und „irgendein Client irgendeiner Firma".
Fragen
support@aircargobook.com — gerne mit Request, Antwort und Zeitstempel, dann finden wir es in den Logs.