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é | Valeur | Description |
|---|---|---|
X-API-KEY | {{apiKey}} | Votre clé d'API unique. |
Content-Type | multipart/form-data | Nécessaire pour l'envoi de fichiers. |
Accept | application/json | La 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 untemplateId(ou utilise untemplateIdglobal fourni en plus) et lesdata(variables) à appliquer pour générer une prévisualisation.
Exemple de structure attendue pour le fichier Excel :
| preview_id (optionnel) | template_id | variable1_nom | variable2_prix | ... |
|---|---|---|---|---|
| preview_1 | template_id_abc | Texte A | 10.99 | ... |
| preview_2 | template_id_def | Texte B | 25.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(ou201 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" }
]
}