Documentation API Upload
Accès Admin

API Upload d'Images

API sécurisée pour le téléchargement et la gestion d'images

Informations Générales

URL de base
Format de réponse JSON
Limite de taille 20MB par fichier
Formats supportés JPEG, JPG, PNG, GIF, WebP

Authentification

Authentification Requise

Toutes les routes d'upload et de suppression nécessitent une clé API valide dans le header Authorization.

Contactez l'administrateur pour obtenir les clés d'accès.

Header Authorization

Authorization: Bearer [VOTRE_CLE_API]

Endpoints API

POST
/upload/single
Télécharger une seule image

Endpoint pour télécharger une image unique avec validation et stockage sécurisé.

Headers requis :

Authorization: Bearer [VOTRE_CLE_API] Content-Type: multipart/form-data

Body (form-data) :

  • image - Fichier image (requis)
Réponse succès (200) 
{
  "success": true,
  "message": "Image téléchargée avec succès",
  "data": {
    "filename": "img_123abc.jpg",
    "originalName": "photo.jpg",
    "size": 2048576,
    "mimetype": "image/jpeg",
    "url": "/uploads/img_123abc.jpg"
  }
}
POST
/upload/multiple
Télécharger plusieurs images (max 10)

Endpoint pour télécharger jusqu'à 10 images simultanément.

Limite : Maximum 10 fichiers par requête

GET
/images
Lister toutes les images avec pagination

Paramètres optionnels :

  • ?page=1 - Numéro de page (défaut: 1)
  • ?limit=20 - Nombre d'items par page (défaut: 20)
  • ?sort=date|name|size - Critère de tri
  • ?order=asc|desc - Ordre de tri (défaut: desc)
/images?page=1&limit=20&sort=date&order=desc
GET
/images/:filename/info
Obtenir les informations d'une image

Récupère les détails complets d'une image spécifique par son nom de fichier.

DELETE
/images/:filename
Supprimer une image spécifique

Supprime définitivement une image du serveur. Cette action est irréversible.

Attention : Cette opération est permanente.

Codes de Statut HTTP

Code Signification Description
200 OK Requête réussie
201 Created Ressource créée avec succès
400 Bad Request Requête invalide ou mal formée
401 Unauthorized Authentification requise ou invalide
403 Forbidden Accès refusé / Permissions insuffisantes
404 Not Found Ressource non trouvée
413 Payload Too Large Fichier trop volumineux (>20MB)
500 Server Error Erreur interne du serveur