Retrieve file from S3
GET/truckers/files/
Ruft eine in Amazon S3 gespeicherte Datei ab.
Dieser Endpunkt ermöglicht das Abrufen generischer Dateien (PDFs, Bilder, Binärdateien), die zuvor in das System hochgeladen wurden. Erfordert Authentifizierung per JWT und den exakten Dateinamen der abzurufenden Datei.
Anwendungsfälle:
- PDF-Dokumente wie Rechnungen oder Verträge herunterladen
- Profilbilder oder gescannte Dokumente anzeigen
- Spezifische Binärdateien wiederherstellen
Beispiel:
GET /?file=rechnung_12345.pdf
Request
Responses
- 200
- 404
- 500
Datei erfolgreich von S3 abgerufen.
Der zurückgegebene Inhalt variiert je nach angefordertem Dateityp:
- PDF: application/pdf
- Bilder: image/jpeg oder image/png
- Andere Typen: application/octet-stream
Beispiel einer erfolgreichen Antwort:
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=rechnung_12345.pdf
[Binärdaten]
Response Headers
Die angeforderte Datei existiert nicht in S3.
Mögliche Ursachen:
- Falscher Dateiname
- Die Datei wurde gelöscht
- Die Datei wurde nie hochgeladen
Beispielantwort:
{
error: File not found,
message: Die angeforderte Datei existiert nicht
}
Response Headers
Interner Serverfehler beim Versuch, die Datei abzurufen.
Mögliche Ursachen:
- Verbindungsprobleme mit S3
- Unzureichende Berechtigungen
- Unerwarteter Serverfehler
Beispielantwort:
{
error: Internal Server Error,
message: Die Datei konnte nicht abgerufen werden
}