Configuration initiale
Au premier lancement, Stockaj Kiosk affiche automatiquement l'écran de configuration. Cet écran permet de connecter le kiosk à votre instance Stockaj.
screenshot-setup-screen.png — Vue complète de l'écran de configuration avec les 3 champs et les boutons.
Champs de configuration
URL de l'API
L'adresse de votre serveur Stockaj. La valeur par défaut est :
https://app.stockaj.io/api/v2
Modifiez cette valeur uniquement si vous utilisez une instance Stockaj auto-hébergée.
Jeton d'API (Bearer Token)
Le jeton d'authentification qui permet au kiosk de communiquer avec l'API. Ce jeton est généré depuis l'interface d'administration de Stockaj.
- Connectez-vous à votre interface Stockaj
- Accédez aux Paramètres → Jetons d'API
- Créez un nouveau jeton avec les permissions de kiosk
- Copiez le jeton et collez-le dans ce champ
Le jeton est stocké localement sur la machine. Assurez-vous que seul le personnel autorisé a accès au poste.
Code PIN (optionnel)
Un code à 4 chiffres qui protège l'accès à cet écran de configuration. Si un PIN est défini, il sera demandé chaque fois qu'un utilisateur tente d'accéder aux paramètres depuis la barre de navigation.
- Seuls les chiffres sont acceptés
- Maximum 4 caractères
- Laissez vide pour désactiver la protection
Tester la connexion
Avant d'enregistrer, vous pouvez vérifier que la connexion fonctionne en cliquant sur « Tester la connexion ».
| Résultat | Affichage |
|---|---|
| ✅ Succès | « Connexion réussie ✓ » (texte vert) |
| ❌ Échec | « Échec ✗ » suivi d'un message d'erreur (texte rouge) |
screenshot-setup-test-success.png — Message de succès après test de connexion
screenshot-setup-test-error.png — Message d'erreur après test échoué
Messages d'erreur courants
| Message | Cause probable |
|---|---|
| Impossible de joindre le serveur. | URL incorrecte ou serveur inaccessible |
| Erreur inconnue. | Jeton invalide ou problème réseau |
Enregistrer et lancer
Une fois la connexion testée avec succès, cliquez sur « Enregistrer et lancer » pour sauvegarder la configuration et accéder au cockpit.
Les paramètres sont persistés localement. Vous n'aurez pas besoin de les re-saisir au prochain lancement, sauf si vous réinitialisez la configuration.
Modifier la configuration plus tard
Pour revenir à cet écran après la configuration initiale :
- Depuis la barre de navigation, cliquez sur l'icône engrenage (⚙️) à droite
- Si un code PIN est configuré, saisissez-le dans la boîte de dialogue
- L'écran de configuration s'affiche avec les valeurs actuelles
screenshot-pin-dialog.png — Boîte de dialogue de saisie du code PIN avec pavé numérique.