Importer des Stations de Base via Excel
Cette requête permet d'importer plusieurs stations de base en une seule opération à partir d'un fichier Excel.
Méthode : POST
URL : {{baseUrl}}/api/horstable/basestation/importBaseStation
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. |
Corps de la requête (multipart/form-data) :
Le corps doit contenir le fichier Excel avec les données des stations de base.
file: Le fichier Excel (.xlsx,.xls) contenant les informations des stations.
Exemple de structure attendue pour le fichier Excel :
| id | name | ipAddress | macAddress | location | status |
|---|---|---|---|---|---|
| BS_002_Store_Lyon_01 | Station Base - Lyon Part-Dieu | 192.168.2.10 | 00:AA:BB:CC:DD:EE | Magasin Lyon Part-Dieu, Zone B | online |
| BS_003_Warehouse_Mars_01 | Station Entrepot Marseille | 10.0.0.5 | 00:11:22:33:44:55 | Entrepot Marseille, Dock 1 | offline |
Note : La structure exacte du fichier Excel et les champs requis peuvent varier. Un modèle peut être téléchargeable via une autre route API (voir "Télécharger le modèle Excel").
Réponses possibles :
201 Created(ou200 OK) : Importation réussie. Un résumé de l'importation peut être retourné.400 Bad Request: La requête est malformée, le fichier est manquant, ou le format du fichier est incorrect.422 Unprocessable Entity: Les données dans le fichier Excel ne sont pas valides ou des erreurs se sont produites lors du traitement de certaines lignes. Un rapport d'erreurs peut être retourné.
Exemple de réponse (Succès) :
{
"status": "success",
"message": "Base stations import operation completed.",
"total_rows": 50,
"successful_imports": 48,
"failed_imports": 2,
"errors": [
{
"row_number": 15,
"error_message": "Invalid MAC address format for station ID BS_INVALID_01"
}
// ... autres erreurs si applicable
]
}