ESGO API
Verbinden Sie Ihr TMS oder ERP direkt mit ESGO: freie Kapazität auf bestehenden Fahrten suchen, offene Transportanfragen einstellen und die gefundenen Treffer abrufen. Die Schnittstelle arbeitet mit JSON über HTTPS und ist vollständig als OpenAPI 3 beschrieben.
So erhalten Sie Zugang
API-Schlüssel
Den Schlüssel stellt Ihnen ESGO bereit. Er gehört zu Ihrem Verlader-Konto, gilt nur für die freigegebenen Bereiche und lässt sich jederzeit widerrufen.
Authentifizierung
Jede Anfrage trägt den Schlüssel im Header:
Authorization: Bearer esgo_live_...
Basis-URL
https://api.es-go.de/v1
Innerhalb von v1 kommen nur Felder und Endpunkte hinzu, bestehende bleiben erhalten.
Endpunkte
/v1/matches/search
matches:read
/v1/me
/v1/open-requests
open_requests:write
/v1/open-requests/{request_id}/matches
open_requests:read
Beispiel: freie Kapazität suchen
Gewichte in Kilogramm, Zeiten im Format ISO 8601. Ohne Zeitzonenangabe gilt die Ortszeit in Deutschland.
curl -X POST https://api.es-go.de/v1/matches/search \
-H "Authorization: Bearer esgo_live_..." \
-H "Content-Type: application/json" \
-d '{"origin": "47057 Duisburg", "destination": "80331 München", "weight_kg": 12000, "loading_meters": 4.8}'Grenzen je Schlüssel
- 60 Aufrufe pro Minute, 1000 pro Stunde, 10000 pro Tag
- 200 Kapazitätssuchen pro Tag
- 50 neue Transportanfragen pro Tag
- Eine Suche liefert bis zu 25 Treffer.
Bei Überschreitung antwortet die API mit Status 429 und nennt im Header Retry-After die Wartezeit in Sekunden.
Fehlerformat
Jede Fehlerantwort hat dieselbe Form: type nennt die Kategorie, code den genauen Grund, param das betroffene Feld.
{
"error": {
"type": "invalid_request_error",
"code": "invalid_parameter",
"message": "Missing data for required field.",
"param": "weight_kg"
}
}Jede Antwort trägt eine X-Request-Id. Nennen Sie sie, wenn Sie uns zu einem Aufruf kontaktieren.
Preise und Buchung
ESGO vermittelt Transporte und ist kein Frachtführer. Preise in Suchergebnissen sind unverbindliche Schätzungen, ein Festpreis ist das Angebot der jeweiligen Spedition. Gebucht wird auf es-go.de: Jeder Treffer enthält einen Link in den Buchungsablauf.
Sie möchten die API anbinden?
Wir richten Ihren Zugang ein und begleiten die ersten Aufrufe.
Zugang anfragen