Skip to main content

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éValeurDescription
X-API-KEY{{apiKey}}Votre clé d'API unique.
Content-Typemultipart/form-dataNé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 :

idnameipAddressmacAddresslocationstatus
BS_002_Store_Lyon_01Station Base - Lyon Part-Dieu192.168.2.1000:AA:BB:CC:DD:EEMagasin Lyon Part-Dieu, Zone Bonline
BS_003_Warehouse_Mars_01Station Entrepot Marseille10.0.0.500:11:22:33:44:55Entrepot Marseille, Dock 1offline

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 (ou 200 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
]
}