Les clés API de Fixh IT transforment le logiciel de votre centre de réparation en une plateforme ouverte : depuis Entreprise > Clés API, votre entreprise peut générer et révoquer des clés API REST v1, utilisées dans l'en-tête X-API-Key pour authentifier les requêtes vers le point de terminaison /api/v1/company/... Ce n'est pas une fonction réservée aux développeurs isolés : c'est le pont entre votre atelier de réparation et le reste de votre écosystème logiciel, de votre site web à votre logiciel de comptabilité, de votre CRM au bot qui répond à vos clients. Pour des raisons de sécurité, la clé complète n'est affichée à l'écran qu'une seule fois, juste après sa création : à partir de ce moment, elle n'est visible que sous forme masquée (le key_prefix), il faut donc la copier et la conserver immédiatement en lieu sûr.
Pourquoi c'est important pour un centre de réparation
Un atelier de réparation de smartphones et d'ordinateurs travaille rarement avec un seul outil : il y a le logiciel de gestion principal, peut-être un site e-commerce pour les pièces détachées, un chatbot qui répond aux clients sur WhatsApp ou Telegram, un logiciel de comptabilité pour la facturation, un outil marketing pour les campagnes d'e-mails. Sans une véritable intégration, toutes ces informations restent cloisonnées dans chaque système, obligeant le personnel à saisir les mêmes données plusieurs fois, avec un risque réel d'erreurs de saisie et de retards dans la communication au client. Les clés API REST v1 résolvent exactement ce problème : elles permettent à un système externe de dialoguer automatiquement avec les données de réparation de votre entreprise sur Fixh IT, en lisant le statut d'un ticket, en créant de nouvelles réparations depuis un formulaire en ligne, ou en mettant à jour un ticket lorsqu'un technicien marque une intervention comme terminée. Pour un centre de réparation qui gère des dizaines voire des centaines de réparations par mois, cette intégration entre réparations de smartphones et d'ordinateurs et logiciels externes peut faire toute la différence entre un flux de travail fluide et un flux plein de double saisie manuelle.
En pratique
Chaque clé API générée est associée à votre entreprise (key_type "company") et permet à un système externe de s'authentifier auprès des API REST v1 de Fixh IT en incluant la clé dans l'en-tête X-API-Key de chaque requête HTTP. Avec ce type de clé, vous pouvez consulter la liste des réparations de votre entreprise avec des filtres par boutique, statut ou texte de recherche, lire le détail d'une réparation, en créer de nouvelles en précisant la boutique, le client, le technicien, l'appareil, la panne constatée, les accessoires remis et le devis, ou mettre à jour une réparation existante en changeant son statut, son paiement, sa livraison ou ses notes internes. Chaque requête est toujours automatiquement filtrée selon l'entreprise à laquelle appartient la clé : un système externe ne peut jamais voir ni modifier les données d'une autre entreprise du réseau, même par erreur, car le contrôle s'effectue côté serveur sur chaque requête.
Pour des raisons de sécurité, la clé complète (la chaîne secrète réelle) s'affiche à l'écran une seule fois, juste après sa création : par la suite, le système ne conserve qu'un hachage de la clé et n'affiche dans la liste que son préfixe initial (key_prefix), suffisant pour la reconnaître mais pas pour la réutiliser. Il est donc essentiel de copier immédiatement la clé et de la coller dans le fichier de configuration du système externe qui l'utilisera, avant de fermer la fenêtre : si vous l'oubliez, la seule solution est de révoquer cette clé et d'en générer une nouvelle. Chaque clé affiche aussi sa date de dernière utilisation, utile pour savoir si une intégration est encore active ou si elle peut être désactivée sans risque car elle n'est plus utilisée. Si une clé est perdue, compromise ou n'est plus nécessaire, vous pouvez la révoquer à tout moment depuis la liste : une fois révoquée, elle cesse immédiatement de fonctionner, la date de révocation est enregistrée, et tout système qui l'utilisait perd instantanément l'accès aux API, sans qu'il soit nécessaire d'intervenir ailleurs.
Aux côtés des clés de type entreprise, le même dispositif technique comprend aussi un type de clé réservé aux revendeurs du réseau Fixh IT, utilisée pour gérer automatiquement l'émission et le contrôle des codes de licence depuis leur propre logiciel de gestion : les deux types de clés sont totalement séparés (gardes et permissions distincts), et une clé entreprise ne peut jamais être utilisée pour des opérations réservées aux revendeurs, et inversement.
Guide rapide
- Allez dans Entreprise > Clés API.
- Créez une nouvelle clé API en lui donnant un nom descriptif qui identifie clairement l'intégration (par exemple « Site e-commerce de pièces » ou « Bot de support WhatsApp »).
- Copiez immédiatement la clé complète affichée à l'écran : elle ne sera plus jamais affichée en entier par la suite, seulement sous forme masquée.
- Collez la clé dans le fichier de configuration du système externe, dans la variable prévue pour l'en-tête X-API-Key.
- Configurez le système externe pour qu'il envoie la clé dans l'en-tête X-API-Key à chaque requête vers /api/v1/company/repairs et les autres points de terminaison disponibles.
- Testez l'intégration avec un appel d'essai, par exemple la lecture de la liste des réparations, pour vérifier que la réponse contient les données attendues.
- Vérifiez périodiquement la date de dernière utilisation de chaque clé pour repérer les intégrations qui ne sont plus actives.
- Si nécessaire, révoquez la clé depuis la liste pour en interrompre immédiatement l'utilisation, par exemple lors d'un changement de prestataire de site web ou de l'abandon d'un outil externe.
Cas d'usage réels
Formulaire de demande de réparation sur le site web. Un atelier de réparation de smartphones intègre à son site un formulaire « demander une réparation » : lorsqu'un client le remplit, un script externe appelle le point de terminaison de création de réparation avec l'en-tête X-API-Key, générant automatiquement un nouveau ticket dans le système, déjà affecté à la bonne boutique et prêt à être pris en charge par un technicien, sans que personne n'ait à recopier les données du site vers le système.
Synchronisation avec un logiciel de comptabilité externe. Une entreprise multi-boutiques utilise un logiciel de comptabilité séparé pour la facturation : une intégration planifiée lit chaque nuit, via la clé API, les réparations marquées comme payées et livrées au cours des dernières 24 heures, et les importe dans le logiciel comptable pour l'enregistrement fiscal, évitant la double saisie manuelle.
Notifications automatiques au client via un bot. Un centre de réparation connecte un bot de messagerie à son système : lorsqu'un technicien fait passer le statut d'une réparation de « en cours » à « prête à récupérer » via l'API, le bot externe vérifie périodiquement les réparations récemment mises à jour et envoie automatiquement un message au client, réduisant les appels en boutique pour demander où en est la réparation.
Conseils et bonnes pratiques
Créez une clé API distincte pour chaque intégration plutôt que de réutiliser la même clé partout : ainsi, si un système externe est mis hors service ou compromis, vous pouvez révoquer uniquement cette clé sans devoir reconfigurer toutes les autres intégrations. Donnez à chaque clé un nom descriptif qui rappelle en un coup d'œil son usage, surtout si vous en accumulez plusieurs au fil du temps. Vérifiez périodiquement la date de dernière utilisation pour repérer les clés « oubliées » liées à des systèmes que vous n'utilisez plus, et révoquez-les : moins il y a de clés actives, plus la surface d'attaque est réduite. Conservez la clé complète dans un gestionnaire de mots de passe ou un fichier de configuration protégé, jamais dans un document partagé ou un message de chat.
Erreurs courantes à éviter
Ne partagez jamais la même clé API entre plusieurs intégrations différentes : si vous devez en désactiver une à l'avenir, vous risquez d'interrompre aussi les autres. N'intégrez pas la clé directement dans le code source public d'un site ou d'une application : elle doit toujours rester dans un fichier de configuration séparé et non versionné. Ne comptez pas pouvoir récupérer la clé complète après avoir fermé la fenêtre la première fois : si vous oubliez de la copier, la seule solution est de la révoquer et d'en générer une nouvelle. Enfin, n'oubliez pas de révoquer les clés des intégrations abandonnées : une clé active mais inutilisée reste un point d'accès potentiel aux données de vos réparations.
Pour aller plus loin
- Fixh Assistant : le chatbot WhatsApp avec Fixh AI pour votre centre de réparation
- Vitrine d'Entreprise : vendez en ligne les produits de votre stock
- Exporter toutes les données de l'entreprise : réparations, documents, clients et tickets dans une archive ZIP
Questions fréquentes
Puis-je revoir la clé complète après l'avoir créée ? Non, pour des raisons de sécurité la clé complète n'est affichée qu'à sa création ; si vous la perdez, vous devez la révoquer et en générer une nouvelle.
Que se passe-t-il si je révoque une clé API ? La clé cesse immédiatement de fonctionner, la date de révocation est enregistrée, et toute requête qui l'utilise est rejetée par le système.
Puis-je créer plusieurs clés API pour la même entreprise ? Oui, vous pouvez générer plusieurs clés, par exemple une par intégration ou système externe connecté, et les révoquer individuellement sans affecter les autres.
Quelles données puis-je lire ou écrire avec une clé API entreprise ? Les réparations de votre entreprise : vous pouvez les lister, les filtrer par boutique ou statut, en créer de nouvelles et mettre à jour le statut, le paiement, la livraison et les notes internes des réparations existantes, toujours limitées automatiquement à votre entreprise.
Les clés API sont-elles différentes de celles utilisées par les revendeurs pour les licences ? Oui, il existe deux types de clés totalement séparés : les clés entreprise pour les réparations et les clés revendeur pour la gestion des codes de licence, avec des permissions et des périmètres distincts.
Faut-il des compétences techniques pour utiliser les clés API ? Oui, l'intégration nécessite que le système externe (site, bot, logiciel tiers) soit programmé pour envoyer des requêtes HTTP avec l'en-tête X-API-Key : elle est conçue pour des développeurs ou des éditeurs de logiciels qui collaborent avec votre centre de réparation.
