Skip to main content
POST
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.
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.

Validation

  • Extension et type MIME doivent tous deux figurer dans la liste autorisée de la catégorie file_type détectée — une incohérence (par ex. une extension .png sur 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 plan DOCUMENT_FILE_SIZE du 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

Autorisations

Authorization
string
header
requis

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.