Serveur API
Démarrez un serveur API REST intégré pour générer des étiquettes depuis des applications externes, des apps Android, des plugins Chrome et des intégrations personnalisées. Comprend un tableau de bord web complet avec gestion des utilisateurs, monitoring et API Explorer.
Panneau de contrôle
Le panneau de contrôle dans Label Creator permet de démarrer, arrêter et configurer le serveur API.
Vérifications du serveur
- Démarrer le serveur — Démarrer le serveur API
- Arrêter le Serveur — Arrêter le serveur
- Redémarrer le Serveur — Redémarrer le serveur
Configuration
- Host — Adresse d’écoute du serveur (défaut : localhost)
- Port — Port du serveur (défaut : 8000)
- Auto-start — Démarrer automatiquement le serveur à l’ouverture de l’écran
- Désactiver l'ouverture automatique de la fenêtre de débogage — Ne pas ouvrir la fenêtre de débogage au démarrage
- Enregistrer Configuration — Enregistrer les paramètres
- Réinitialiser le Mot de Passe Admin — Réinitialiser le mot de passe administrateur
État du serveur
Affiche l’état actuel du serveur (Started/Stopped) et l’URL d’accès au tableau de bord web.
Si vous exposez le serveur sur une adresse autre que localhost (ex. 0.0.0.0), il sera accessible depuis d’autres appareils sur le réseau. Assurez-vous de configurer des utilisateurs et des permissions adéquats avant d’ouvrir l’accès réseau.
Gestion des profils et layouts
Importez, renommez, dupliquez et supprimez les profils et layouts rendus disponibles via les API du serveur.
Profils du serveur API
Profils visibles et appelables via API (app Android, plugin Chrome, intégrations externes). Filtre rapide pour une recherche rapide. Boutons : Importer depuis un dossier local, Renommer, Dupliquer, Supprimer, Actualiser, Ouvrir le dossier.
API du serveur de mise en page
Layouts visibles et appelables via API. Mêmes contrôles que l’onglet profils.
Partage client
Partagez physiquement des profils, layouts et bases de données permanentes avec d’autres installations de Label Creator configurées comme clients. Sélectionnez les ressources et cliquez sur Partager les éléments sélectionnés pour les partager ou Retirer le partage pour révoquer le partage.
Tableau de bord web
Une fois le serveur démarré, accédez au tableau de bord web depuis votre navigateur. La page d’accueil présente quatre sections principales :
- Administration — Gestion des utilisateurs, permissions personnalisées, configuration des pages et statistiques système
- System Monitoring — Performances du serveur, état des services et statistiques d’utilisation en temps réel
- API Explorer — Explorez et testez interactivement toutes les API REST avec l’interface Swagger intégrée
- Guide and Documentation — Guides d’utilisation, exemples pratiques et dépannage
Surveillance du serveur
Surveillance en temps réel des journaux, statistiques et performances du serveur.
Le tableau de bord de monitoring se met à jour en temps réel. Gardez-le ouvert pendant les opérations critiques pour vérifier l’état du serveur et identifier d’éventuelles erreurs.
Système
Métriques système : CPU, mémoire, E/S disque, Uptime et connexions actives.
Serveur API
Statistiques API : requêtes totales, succès, erreurs, taux de réussite et temps de réponse moyen.
Requêtes des dernières 24 h
Graphique des requêtes des dernières 24 heures avec Quick Metrics pour le total des requêtes.
Journaux du serveur
Journaux du serveur avec filtres par niveau et type. Boutons Approve, Freeze et API Docs pour gérer les journaux. Auto-refresh disponible.
Gestion des utilisateurs
Gestion avancée des utilisateurs avec rôles, permissions et restrictions IP.
- User list — Tableau avec Username, Email, Rôle, Permissions, Statut, Restrictions IP, Offline Login et Actions
- Filtres — Filtrer par nom d’utilisateur, rôle, statut et restrictions IP
- New User — Créer un nouvel utilisateur
- Modifier — Modifier un utilisateur existant
- Supprimer — Supprimer l’utilisateur
Modifier l’utilisateur
Modifiez les détails d’un utilisateur : nom d’utilisateur, email, nom complet, rôle, mot de passe, description et restrictions IP.
Permissions organisées par catégorie :
- Core — Impression d’étiquettes (API), Fonctionnalités avancées
- Profiles — Gestion des profils
- Administrateur — Administration
- Système — Surveillance
- Outils — API Explorer
Explorateur d'API
Interface Swagger intégrée pour explorer et tester interactivement toutes les API REST du Label System.
- Server status — Serveur en ligne avec URL, Health Check, Webhooks et version OpenAPI
- Authorize — Authentifier les requêtes API
- Endpoints — Tous les endpoints regroupés par catégorie (authentification, génération d’étiquettes, etc.)
Authentification
Endpoints pour login, logout, gestion des sessions et vérification des permissions. Chaque endpoint affiche la méthode HTTP (POST/GET), le chemin, les paramètres et les réponses attendues.
API de génération d’étiquettes
Endpoints pour la génération d’étiquettes. Chaque endpoint se déplie pour afficher les paramètres, le bouton Execute et les réponses avec code et body d’exemple.
Permissions de page
Configurez quels rôles peuvent accéder à chaque page du tableau de bord web. Le tableau affiche Page Path, Description, Required Permissions, Modifiable et Actions.
Configurer les permissions de page
La fenêtre de modification permet de définir le Page Path, la description, les permissions requises (Label Printing, Advanced Features, Profile Management, Administration, Monitoring, API Explorer) et s’il faut exiger toutes les permissions sélectionnées ou au moins une.
Permissions personnalisées
Affichez et gérez les permissions personnalisées organisées par catégorie : Core, Profiles, Admin et System. Les permissions système ne sont pas modifiables.
Nouvelle permission personnalisée
Créez une nouvelle permission personnalisée en spécifiant Permission Name, Display Name, Description et Category. La permission sera disponible dans la configuration des utilisateurs et des pages.
Sécurité & Audit
Journaux de sécurité et piste d’audit avec un aperçu des activités du système.
- Compteurs — Events (login), Successful (logins), Failed (logins), Blocked IPs
- Onglets — Dashboard, Audit Events, Blocked IPs, Timeline
- Recent Suspicious Activity — Activités suspectes récentes
- Top IPs by Activity — Adresses IP les plus actives
- Active Users — Utilisateurs actifs actuels
- Security Configuration — Paramètres de sécurité du serveur
Statistiques système
Aperçu détaillé des statistiques système.
- Summary cards — Total utilisateurs, Utilisateurs actifs, Avec restrictions IP, Connexions sécurisées (TLS)
- Users by Role — Répartition des utilisateurs par rôle (admin, printer, etc.)
- Users by Permission — Répartition des utilisateurs par permission attribuée (print, advanced, profiles, admin, monitoring, api_explorer)