Erscheinungsbild
Angebote auf Frachten. Ein Angebot gehört immer zu genau einer Fracht.
Angebote abrufen geht nicht hier
Es gibt keinen GET-Endpunkt für Angebote. Sie kommen als data.route._bids in der Antwort von GET /freights/view/{id}.json mit.
Die Endpunkte hier dienen dem Abgeben, Zurückziehen und Bestätigen.
Der Zuschlag ist zweistufig
POST /quotes/confirm/{bidId}.json bestätigt eine Seite. Erst wenn beide Seiten bestätigt haben, wechselt die Fracht auf taken und winner sowie price werden gesetzt.
Der erste Aufruf antwortet mit einem Redirect. Verifiziere den Zustand danach über GET /freights/view/{routeId}.json, statt dem Response-Body zu vertrauen.
Quotes
Angebote auf Frachten. URL-Segment /quotes/….
Ein Angebot gehört immer zu genau einer Fracht. Abgerufen werden Angebote nicht
hier, sondern über die Fracht selbst — siehe GET /freights/view/{id}.json.
Angebot abgeben oder aktualisieren
POST
/quotes/add.json
Gibt ein Angebot (Bid) auf eine Fracht ab. Mit gesetzter id wird ein
bestehendes Angebot aktualisiert, ohne id ein neues mit status = open erzeugt.
Automatisch gesetzt: company und user aus dem Token-User,
display_company_id (falls leer). Bietet die Company der Fracht selbst,
wird type = selling.
Authorizations
authTokenHeader
Empfohlen. Dein API-Token als Header. Das Schema heißt ApplePass —
historisch bedingt, aber so muss es lauten:
Authorization: ApplePass DEIN_TOKEN
Den Token holst du über
POST /users/login.json.
Type
API Key (header: Authorization)
or
authTokenQuery
Derselbe Token als Query-Parameter: ?auth_token=DEIN_TOKEN.
Praktisch für curl und schnelle Tests.
Nicht für produktive Integrationen verwenden: Query-Parameter landen in
Server-Logs, Proxy-Logs und Browser-Referrern. Nutze dortauthTokenHeader.
Type
API Key (query: auth_token)
Request Body
application/json
JSON "route": 12345, "amount": 1875.5, "currency_code": "EUR", "rate_base": 1500, "rate_fsc": 275.5, "rate_ssc": 100, "note": "Direktflug, Abflug wie angefragt"
{
}
Responses
Angebot gespeichert.
application/json
JSON
"string"
Angebot bestätigen / Zuschlag erteilen
POST
/quotes/confirm/{bidId}.json
Zweistufige Bestätigung: jede Seite bestätigt einmal. Erst wenn beide Seiten
bestätigt haben, wird die Fracht auf status = taken gesetzt, winner und
transport_company_id auf die Bieter-Company, route.price auf den Angebotsbetrag —
und alle anderen pending-Angebote fallen auf open zurück.
Dieser Endpunkt antwortet je nach Bestätigungsstufe mit einem Redirect statt mit
verwertbarem JSON. Verifiziere den Zustand danach über
GET /freights/view/{routeId}.jsonund prüfestatussowiewinner, statt dem
Response-Body zu vertrauen.
Authorizations
authTokenHeader
Empfohlen. Dein API-Token als Header. Das Schema heißt ApplePass —
historisch bedingt, aber so muss es lauten:
Authorization: ApplePass DEIN_TOKEN
Den Token holst du über
POST /users/login.json.
Type
API Key (header: Authorization)
or
authTokenQuery
Derselbe Token als Query-Parameter: ?auth_token=DEIN_TOKEN.
Praktisch für curl und schnelle Tests.
Nicht für produktive Integrationen verwenden: Query-Parameter landen in
Server-Logs, Proxy-Logs und Browser-Referrern. Nutze dortauthTokenHeader.
Type
API Key (query: auth_token)
Parameters
Path Parameters
bidId*
Type
Requiredinteger
Responses
Bestätigung verarbeitet.
application/json
JSON
"string"
Angebot zurückziehen
POST
/quotes/revoke/{bidId}.json
Zieht ein eigenes Angebot zurück (status = revoked). Danach zählt es in den
Frachtlisten nicht mehr als abgegebenes Angebot — die Fracht erscheint für die
eigene Company wieder unter „noch nicht geboten" (Filter 8).
Authorizations
authTokenHeader
Empfohlen. Dein API-Token als Header. Das Schema heißt ApplePass —
historisch bedingt, aber so muss es lauten:
Authorization: ApplePass DEIN_TOKEN
Den Token holst du über
POST /users/login.json.
Type
API Key (header: Authorization)
or
authTokenQuery
Derselbe Token als Query-Parameter: ?auth_token=DEIN_TOKEN.
Praktisch für curl und schnelle Tests.
Nicht für produktive Integrationen verwenden: Query-Parameter landen in
Server-Logs, Proxy-Logs und Browser-Referrern. Nutze dortauthTokenHeader.
Type
API Key (query: auth_token)
Parameters
Path Parameters
bidId*
Type
Requiredinteger
Responses
Angebot zurückgezogen.
application/json
JSON
"string"