Batch JSON + Mise à Jour des Données
Cette requête permet d'appliquer des données en lot à des modèles (templates) en utilisant un corps de requête JSON et de mettre à jour les écrans correspondants.
Méthode : POST
URL : {{baseUrl}}/api/horstable/template/batch-painting-json
En-têtes :
| Clé | Valeur | Description |
|---|---|---|
X-API-KEY | {{apiKey}} | Votre clé d'API unique. |
Content-Type | application/json | Nécessaire pour l'envoi de données JSON. |
Corps de la requête (JSON) :
Le corps doit contenir l'identifiant du modèle et un tableau de données pour chaque étiquette à mettre à jour.
Exemple de corps de requête :
{
"templateId": "template_xyz789", // ID du modèle à appliquer
"data": [ // Tableau des mises à jour à appliquer
{
"labelId": "label_001", // ID de l'étiquette cible
"variables": { // Variables du modèle à populer pour cette étiquette
"productName": "Produit Alpha",
"price": "19.99",
"promoText": "Offre Spéciale !"
}
},
{
"labelId": "label_002",
"variables": {
"productName": "Produit Beta",
"price": "29.99"
}
}
// ... autres étiquettes et leurs données
]
}
Note : templateId spécifie le modèle à utiliser pour toutes les mises à jour de ce lot. Chaque objet dans le tableau data doit contenir un labelId pour identifier l'étiquette et un objet variables avec les paires clé/valeur correspondantes aux variables du modèle.
Réponses possibles :
201 Created(ou200 OK) : Opération de batch effectuée avec succès. Un résumé des opérations peut être retourné.400 Bad Request: La requête est malformée ou les données JSON sont incorrectes.422 Unprocessable Entity: Les données fournies ne sont pas valides ou des erreurs se sont produites lors du traitement de certains items. Un rapport d'erreurs peut être retourné.
Exemple de réponse (Succès) :
{
"status": "success",
"message": "Batch JSON painting operation completed.",
"processed_items": 2,
"successful_updates": 2,
"failed_updates": 0,
"errors": []
}