Update an existing vehicle
POST/company/vehicles/:id
Aktualisiert die Informationen eines bestehenden Fahrzeugs, einschließlich Metadaten und Datei-Uploads.
Ziel
Ermöglicht Unternehmen, Fahrzeugspezifikationen zu ändern, Dokumentation zu aktualisieren und Standard-Fahrzeugeinstellungen zu verwalten.
Anwendungsfälle
- Fahrzeugspezifikationen aktualisieren (Typ, Ladefähigkeiten)
- Fahrzeugbilder und ITV-Zertifikate ersetzen oder entfernen
- Versandart und Temperatur-Einstellungen ändern
- Fahrzeug als Standard des Nutzers setzen oder entfernen
Validierungsablauf
flowchart TD
A[Anfrage empfangen] --> B{Nutzer hat Unternehmen?}
B -->|Nein| C[401 CIA_NOT_FOUND]
B -->|Ja| D{Fahrzeug existiert?}
D -->|Nein| E[404 VEHICLE_NOT_FOUND]
D -->|Ja| F{Unternehmen besitzt Fahrzeug?}
F -->|Nein| G[403 CIA_NOT_OWNER]
F -->|Ja| H{Versandart geändert?}
H -->|Ja zu trocken| I[Automatisch fresh_cargo_temp entfernen]
H -->|Ja zu frisch| J{fresh_cargo_temp gültig?}
J -->|Nein| K[400 Temp erforderlich]
J -->|Ja| L[Fahrzeug aktualisieren]
H -->|Nein| L
I --> L
L --> M{default_vehicle = true?}
M -->|Ja| N[Nutzer-Standard aktualisieren]
M -->|Nein| O[Aktualisiertes Fahrzeug zurückgeben]
N --> O
Dateilöschung
Um eine bestehende Datei (Bild oder ITV) zu löschen, senden Sie das Feld mit einem leeren Zeichenkettenwert. Die Datei wird aus dem S3-Speicher entfernt und das Feld wird auf leer gesetzt.
Beispiel:
{
image: ,
itv:
}
Automatisches Verhalten
Request
Responses
- 200
- 401
- 403
- 404
- 503
Fahrzeug erfolgreich aktualisiert.
Response Headers
Benutzer hat kein zugeordnetes Unternehmen.
Das Fahrzeug gehört nicht zum Unternehmen des authentifizierten Benutzers.
Fahrzeug oder Benutzer nicht gefunden.
Server-Fehler während des Updates