Retrieve file from S3
GET/truckers/files/
Recupera un file archiviato su Amazon S3.
Questo endpoint consente di recuperare file generici (PDF, immagini, binari) precedentemente caricati nel sistema. Richiede autenticazione tramite JWT e il nome esatto del file da recuperare.
Casi d'uso:
- Scaricare documenti PDF come fatture o contratti
- Visualizzare immagini del profilo o documenti scansionati
- Recuperare specifici file binari
Esempio:
GET /?file=factura_12345.pdf
Request
Responses
- 200
- 404
- 500
File ottenuto con successo da S3.
Il contenuto restituito varia in base al tipo di file richiesto:
- PDF: application/pdf
- Immagini: image/jpeg o image/png
- Altri tipi: application/octet-stream
Esempio di risposta di successo:
HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=fattura_12345.pdf
[dati binari]
Response Headers
Il file richiesto non esiste in S3.
Possibili cause:
- Nome del file errato
- Il file è stato eliminato
- Il file non è mai stato caricato
Esempio di risposta:
{
error: File not found,
message: Il file richiesto non esiste
}
Response Headers
Errore interno del server durante il tentativo di recupero del file.
Possibili cause:
- Problemi di connessione con S3
- Permessi insufficienti
- Errore imprevisto del server
Esempio di risposta:
{
error: Internal Server Error,
message: Impossibile recuperare il file
}