Get details of a specific vehicle
GET/company/vehicles/:id
Ruft vollständige Details eines bestimmten Fahrzeugs aus dem Fuhrpark des Unternehmens ab.
Ziel
Ermöglicht Unternehmen, vollständige Informationen über ein einzelnes Fahrzeug einzusehen, einschließlich aller Metadaten, Dateiverweise und berechneter Ladungskapazität.
Anwendungsfälle
- Vollständige Fahrzeugdetails vor der Bearbeitung anzeigen
- Fahrzeuginformationen in der Detailansicht darstellen
- URLs für Bilder und ITV-Zertifikate abrufen
- Auf berechnete Ladungskapazitätsbereiche zugreifen
Sicherheit
Dieser Endpunkt validiert die Eigentümerschaft – das Fahrzeug muss dem Unternehmen des authentifizierten Benutzers gehören. Wenn das Fahrzeug existiert, aber einem anderen Unternehmen gehört, wird 403 CIA_NOT_OWNER zurückgegeben.
Bild-URLs
URLs für Bilder und ITV-Zertifikate folgen dem Format /images?file={s3_key}.
Greifen Sie auf diese URLs mit Authentifizierung zu, um die tatsächlichen Dateien abzurufen.
Berechnete Felder
Das Feld cargo wird automatisch basierend auf vehicle_type berechnet und enthält
Volumen- (m³) und Gewichtskapazitätsbereiche (kg).
Request
Responses
- 200
- 400
- 401
- 403
- 404
Fahrzeugdetails erfolgreich abgerufen.
Response Headers
Allgemeiner Fehler beim Abrufen des Fahrzeugs
Benutzer hat kein zugeordnetes Unternehmen.
Verboten. Das Fahrzeug existiert, gehört aber nicht zum Unternehmen des authentifizierten Benutzers. Dies ist ein Sicherheitsfehler, der anzeigt, dass der Benutzer versucht, auf eine Ressource zuzugreifen, die ihm nicht gehört.
Fahrzeug nicht gefunden.