Moteur et API
Connecter les uploads et fournisseurs de médias
Mettez en place des uploads durables et une recherche média optionnelle sans exposer de secrets dans le navigateur.
Vue d’ensemble du guide
Avant de commencer
- L’hôte peut authentifier les uploads.
- Un stockage média durable est configuré.
- Les formats et tailles autorisés sont définis.
Résultat attendu
Les médias uploadés ou générés survivent au rechargement, s’exportent correctement et donnent des erreurs exploitables.
Implémenter l’adaptateur d’upload
L’adaptateur navigateur envoie le fichier et son contexte à l’hôte. Le serveur valide type MIME, extension, dimensions décodées, taille et autorisation avant stockage, puis retourne une URL HTTPS durable.
Conservez le nom original comme métadonnée seulement. Générez le nom de stockage côté serveur et assainissez les SVG avant publication.
Recevoir le fichier sur un endpoint authentifié.
Valider et transformer côté serveur.
Stocker dans un espace durable.
Retourner URL, dimensions, type et identifiant.
Configurer les fournisseurs en sécurité
Pixabay, Pexels, OpenAI, Replicate ou tout service nécessitant une clé secrète doit être appelé par l’hôte. Le navigateur reçoit un résultat normalisé, jamais les identifiants du fournisseur.
Copiez les images générées vers votre stockage avant placement si l’URL est temporaire ou bloque l’utilisation dans un canvas cross-origin.
Garder les clés dans la configuration serveur.
Normaliser les réponses.
Copier le média choisi vers un stockage maîtrisé.
Retourner une URL compatible canvas.
Gérer progression et erreurs
Affichez les états upload, traitement, terminé et échec. Timeout, format rejeté, quota épuisé et problème CORS nécessitent des messages et possibilités de reprise différents.
Annulez les requêtes abandonnées quand le module ferme ou que le designer est détruit.
Afficher la progression.
Transformer les codes d’erreur en messages clairs.
Permettre une nouvelle tentative sûre.
Vérifier l’export du média depuis le canvas.