Retrieve file from S3

GET 
/truckers/files/

Récupère un fichier stocké dans Amazon S3.

Ce point de terminaison permet de récupérer des fichiers génériques (PDF, images, binaires) préalablement téléchargés dans le système. Il nécessite une authentification par JWT et le nom exact du fichier à récupérer.

Cas d'utilisation :

• Télécharger des documents PDF tels que des factures ou des contrats
• Visualiser des images de profil ou des documents scannés
• Récupérer des fichiers binaires spécifiques

Exemple :

GET /?file=facture_12345.pdf

Request

Responses

200

Fichier obtenu avec succès depuis S3.

Le contenu retourné varie selon le type de fichier demandé :

• PDF : application/pdf
• Images : image/jpeg ou image/png
• Autres types : application/octet-stream

Exemple de réponse réussie :

HTTP/1.1 200 OK
Content-Type: application/pdf
Content-Disposition: attachment; filename=facture_12345.pdf

[données binaires]

Response Headers

404

Le fichier demandé n'existe pas dans S3.

Causes possibles :

• Nom de fichier incorrect
• Le fichier a été supprimé
• Le fichier n'a jamais été téléchargé

Exemple de réponse :

{
  error: File not found,
  message: Le fichier demandé n'existe pas
}

Response Headers

500

Erreur interne du serveur lors de la tentative de récupération du fichier.

Causes possibles :

• Problèmes de connexion avec S3
• Permissions insuffisantes
• Erreur inattendue du serveur

Exemple de réponse :

{
  error: Internal Server Error,
  message: Impossible de récupérer le fichier
}

Response Headers