curl -X POST "https://api.scanova.io/media/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "file=@logo.png" \
-F "in_use=qr_logo" \
-F "category=custom-design"
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
Bibliothèque multimédia
Téléverser un fichier
POST /media/
POST
/
media
/
curl -X POST "https://api.scanova.io/media/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "file=@logo.png" \
-F "in_use=qr_logo" \
-F "category=custom-design"
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
Téléverse un fichier, sur l’hôte de l’API de gestion (
api.scanova.io), authentifié avec votre clé d’API de gestion brute.
POST https://api.scanova.io/media/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
Content-Type: multipart/form-data
file
requis
Le fichier à téléverser.
file ou upload est requis.file
Alias de
file — indiquez l’un ou l’autre.string
Catégories séparées par des virgules contre lesquelles restreindre la validation (
image, video, audio, pdf, doc, script). Voir Lister les types de fichiers autorisés pour les critères d’acceptation par catégorie.string
Comment ce fichier est utilisé :
avatar, qr_logo, qr_content, poster, qr_image, profile_pic, banner, smart, thumbnail, ou unknown (par défaut).string
Étiquette de catégorie en texte libre, par ex. un slug de catégorie QR ou
"Custom Design".integer
L’id d’un lot de médias en masse, issu de Créer un lot de médias en masse, pour y associer ce téléversement.
curl -X POST "https://api.scanova.io/media/" \
-H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a" \
-F "file=@logo.png" \
-F "in_use=qr_logo" \
-F "category=custom-design"
{
"id": 4821,
"file": "media/uploads/104/2026/09/20260908_512873_logo.png",
"upload": null,
"file_name": "20260908_512873_logo.png",
"size": 48213,
"human_readable_size": "47.08 KB",
"original_name": "logo.png",
"bulk_media": null,
"mime_type": "image/png",
"file_type": "png",
"in_use": "qr_logo",
"category": "custom-design",
"created": "2026-09-08T10:15:32.120Z",
"modified": "2026-09-08T10:15:32.120Z"
}
Validation
- Extension et type MIME doivent tous deux figurer dans la liste autorisée de la catégorie
file_typedétectée — une incohérence (par ex. une extension.pngsur un fichier qui est en fait un PDF) est rejetée. - Taille vérifiée par rapport à la limite de la catégorie — sauf pour les fichiers
pdf/doc, où le quota de planDOCUMENT_FILE_SIZEdu compte (en Mo) remplace la limite statique. - JavaScript (
.js) téléversé est analysé pour confirmer qu’il s’agit de JS syntaxiquement valide avant la vérification de taille. - SVG analysés à la recherche de scripts intégrés et rejetés en cas de détection.
- Les fichiers sans extension sont purement et simplement rejetés.
400 pour chacune des erreurs de validation ci-dessus, avec un message identifiant le problème.
Voir aussi
- Lister les fichiers téléversés — voir ce qui a déjà été téléversé.
- Lister les types de fichiers autorisés — valider côté client avant de téléverser.
- Supprimer un fichier — en supprimer un.
- Présentation de l’API de gestion — le schéma d’authentification et les règles de quota applicables à cet endpoint.
Autorisations
Send your Management API key as the raw value of the Authorization header — no "Bearer " or "Token " prefix, and no other characters. Example: Authorization: 401f7ac837da42b97f613d789819ff93537bee6a. A header containing more than one space-separated part is rejected outright. Requests also require the request's Host header to be the management API host (e.g. api.scanova.io) — the same key sent to the regular API host will not authenticate.
Réponse
File uploaded.
Cette page vous a-t-elle été utile ?