Skip to main content

Prévisualisation en Lot de Modèles

Cette requête permet de générer des images de prévisualisation pour plusieurs modèles (templates) Horsplace et/ou ensembles de données en une seule fois.

Méthode : POST

URL : {{baseUrl}}/api/horstable/template/batch-preview

En-têtes :

CléValeurDescription
X-API-KEY{{apiKey}}Votre clé d'API unique.
Content-Typemultipart/form-dataNécessaire pour l'envoi de fichiers.
Acceptapplication/jsonLa réponse du proxy sera un JSON.

Corps de la requête (multipart/form-data) :

Le corps doit contenir le fichier Excel avec les données pour chaque prévisualisation.

  • file: Le fichier Excel (.xlsx, .xls). La structure attendue pourrait être similaire à celle du "Batch Painting Excel", où chaque ligne définit un templateId (ou utilise un templateId global fourni en plus) et les data (variables) à appliquer pour générer une prévisualisation.

Exemple de structure attendue pour le fichier Excel :

preview_id (optionnel)template_idvariable1_nomvariable2_prix...
preview_1template_id_abcTexte A10.99...
preview_2template_id_defTexte B25.50...

Note : La structure exacte du fichier Excel et les champs requis (comme un identifiant par ligne pour corréler les résultats) peuvent varier. Référez-vous à la documentation spécifique ou aux modèles fournis par l'API Horsplace.

Réponses possibles :

  • 200 OK (ou 201 Created) : Prévisualisations générées avec succès. La réponse du proxy sera un JSON contenant les résultats de l'API Horsplace distante. Cela inclura probablement des informations sur chaque prévisualisation demandée (par exemple, image en base64, URL de l'image, ou statut).
  • 400 Bad Request: La requête est malformée ou des données sont manquantes/incorrectes.
  • 422 Unprocessable Entity: Impossible de générer une ou plusieurs prévisualisations. Un rapport d'erreurs peut être retourné.

Exemple de réponse (Succès - JSON avec images en base64) :

{
"status": "success",
"message": "Batch preview operation processed.",
"results": [
{
"preview_id_from_excel": "preview_1", // Si un ID était fourni dans le fichier Excel
"templateId": "template_id_abc",
"image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...", // Données de l'image
"status": "success"
},
{
"preview_id_from_excel": "preview_2",
"templateId": "template_id_def",
"image_base64": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAUA...",
"status": "success"
}
],
"errors": [
// { "row_number_in_excel": 5, "error_message": "Template not found: template_id_xyz" }
]
}