Zum Hauptinhalt springen

Soft delete a vehicle from the fleet

DELETE 
/company/vehicles/:id

Markiert ein Fahrzeug als gelöscht (Soft Delete) aus dem Fuhrpark des Unternehmens.

Ziel​

Ermöglicht Unternehmen, Fahrzeuge aus dem aktiven Einsatz zu entfernen, während gleichzeitig der Prüfpfad und die historische Datenintegrität erhalten bleiben.

Anwendungsfälle​

  • Verkaufte oder außer Betrieb genommene Fahrzeuge aus dem aktiven Fuhrpark entfernen
  • Alte Fahrzeuge archivieren, während historische Aufzeichnungen erhalten bleiben
  • Fahrzeugliste bereinigen, ohne Daten zu verlieren

Soft-Delete-Verhalten​

Dieser Endpunkt führt einen Soft Delete mithilfe des mongoose-delete-Plugins durch:

  • Das Fahrzeug wird NICHT dauerhaft aus der Datenbank gelöscht
  • Das Feld deleted wird auf true gesetzt
  • Das Feld deletedAt wird auf den aktuellen Zeitstempel gesetzt
  • Das Fahrzeug wird aus dem Fahrzeug-Array des Unternehmens entfernt
  • Daten verbleiben in der Datenbank zu Prüf- und Wiederherstellungszwecken

WICHTIG: Dies ist KEINE dauerhafte Löschung. Das Fahrzeug kann bei Bedarf potenziell von Datenbankadministratoren wiederhergestellt werden.

Nebeneffekte​

  • Aktualisiert das Unternehmensmodell, um den Fahrzeugverweis aus dem Fahrzeug-Array zu entfernen
  • Das Fahrzeug wird nicht mehr in Fuhrpark-Listen angezeigt

Hinweis: Derzeit gibt es in diesem Endpunkt keine Eigentumsvalidierung. Jeder authentifizierte Benutzer kann jedes Fahrzeug löschen, wenn er die ID kennt. Dies könnte ein Sicherheitsproblem darstellen.

Request​

Responses​

Fahrzeug erfolgreich gelöscht (Soft Delete).

Response Headers