API Cloxo : reliez votre pointeuse à vos autres logiciels
Avec l'API Cloxo, votre caisse, votre planning ou votre logiciel de paie pointe l'arrivée et le départ de vos collaborateurs et récupère les heures, les présences et les rapports mensuels. L'API est incluse dans chaque plan, y compris pendant l'essai.
Cloxo enregistre qui travaille et quand. Ces heures, vous en avez souvent besoin ailleurs : dans votre caisse, dans votre planning ou pour la paie. Avec l’API Cloxo, vos autres logiciels parlent directement à votre pointeuse, sans ressaisie et sans échange de fichiers.
En bref
- API REST en JSON sur HTTPS, décrite dans un fichier OpenAPI
- Pointer l’arrivée, le départ et les pauses depuis votre propre logiciel
- Récupérer les collaborateurs, les présences, les pointages et les rapports mensuels
- Serveur MCP pour les assistants IA
- Incluse dans chaque plan et dans l’essai gratuit
- Une clé créée en une minute, révocable à tout moment
Développeur ? Lisez la documentation de l’API (en anglais).
Ce que vous en faites
| Vous voulez | Voici comment l’API le fait |
|---|---|
| Pointer depuis votre caisse ou votre contrôle d’accès | Votre logiciel envoie un pointage dès que quelqu’un s’identifie. Cloxo en fait un enregistrement. |
| Voir qui est présent maintenant | Une seule requête donne l’état de chaque collaborateur : pointé, en pause ou parti. |
| Transmettre les heures à la paie | Récupérez les pointages d’une période, ou le rapport mensuel par collaborateur, aussi en PDF. |
| Comparer votre planning à la réalité | Comparez les heures prévues et les heures prestées, par jour et par personne. |
| Ajouter de nouveaux collaborateurs | Votre logiciel crée un collaborateur. Il pointe ensuite avec un code PIN. |
Comment ça marche
- Créez une clé. Dans Cloxo, sous Paramètres → API et intégrations. Vous choisissez ce que la clé peut faire : lire les données, pointer ou ajouter des collaborateurs.
- Transmettez la clé à votre fournisseur de logiciel ou à votre développeur. Il lit la documentation et construit l’intégration.
- C’est prêt. Les pointages arrivent dans Cloxo à côté de ceux de l’application, du QR code et de la tablette. Les corrections et les rapports fonctionnent comme d’habitude.
Voici à quoi ressemble un pointage :
curl -X POST "https://app.cloxo.app/api/public/v1/clock-events" \
-H "Authorization: Bearer cloxo_live_…" \
-H "Content-Type: application/json" \
-d '{"action":"clock_in","employee_id":"7c1d6a52-3f0e-4c9b-9a51-2f6f3f1f0b11"}'
La référence complète, avec toutes les possibilités, les codes d’erreur et des exemples, se trouve dans la documentation pour développeurs (en anglais). Un fichier OpenAPI est aussi disponible, à charger dans Postman ou pour générer un client.
Pour les assistants IA : MCP
Cloxo propose aussi un serveur MCP. Grâce à lui, un assistant IA travaille directement avec votre pointeuse. Vous demandez « Qui travaille en ce moment ? » ou « Combien d’heures Sofie a-t-elle prestées en octobre ? » et l’assistant va chercher la réponse lui-même.
Vous connectez l’assistant avec la même clé. Si vous ne lui donnez que le droit de lecture, l’assistant ne peut rien modifier. Le serveur MCP fonctionne avec les programmes capables d’envoyer une clé, comme Claude Code et Cursor.
Une mise en place sûre
- Une clé appartient à une seule entreprise et ne peut jamais voir les données d’une autre.
- Vous choisissez les droits de chaque clé et, si vous le souhaitez, une date d’expiration.
- Vous révoquez une clé en un clic. Elle cesse aussitôt de fonctionner.
- Cloxo ne conserve qu’une empreinte de la clé. La clé elle-même, vous la voyez une seule fois, à la création.
- Tout le trafic est chiffré et les données sont hébergées sur des serveurs européens.
Ce que l’API n’est pas
L’API est une brique de base. Il n’existe pas d’intégration prête à l’emploi avec un logiciel de paie ou un secrétariat social précis : l’intégration, c’est votre fournisseur de logiciel ou un développeur qui la construit. Vous ne voulez rien construire ? L’export PDF ou CSV reste alors le chemin le plus court vers votre comptable.
Questions fréquentes
Cloxo a-t-il une API ?
Oui. Cloxo propose une API REST qui permet à un autre logiciel de pointer l’arrivée et le départ des collaborateurs et de récupérer les collaborateurs, les présences, les pointages et les rapports mensuels. La documentation se trouve sur app.cloxo.app/developers.
L'API coûte-t-elle un supplément ?
Non. L’API est incluse dans chaque plan et fonctionne aussi pendant l’essai gratuit. Il faut un abonnement actif ou un essai en cours.
Puis-je relier Cloxo à mon logiciel de paie ou à mon secrétariat social ?
Il n’existe pas d’intégration prête à l’emploi par logiciel. Vous avez deux voies : l’export PDF ou CSV, que vous transmettez en un clic, ou l’API, avec laquelle votre fournisseur de logiciel récupère les heures automatiquement.
Ai-je besoin d'un développeur ?
Pour l’intégration elle-même, oui : quelqu’un doit relier votre logiciel à l’API. La clé, vous la créez vous-même en une minute, dans les Paramètres.
Est-il sûr de donner une clé API à un fournisseur ?
Oui, si vous la traitez comme un mot de passe. Une clé appartient à une seule entreprise, ne reçoit que les droits que vous choisissez et se révoque en un clic. Cloxo ne conserve qu’une empreinte de la clé, jamais la clé elle-même.
Cloxo fonctionne-t-il avec des assistants IA ?
Oui, via le serveur MCP. Un assistant compatible MCP qui peut envoyer une clé, comme Claude Code ou Cursor, consulte les présences, les heures et les rapports et peut, si vous l’autorisez, pointer l’arrivée et le départ.
Pour commencer
Créez un compte, ajoutez un collaborateur et créez votre première clé. Pendant l’essai, l’API fonctionne entièrement, sans moyen de paiement. Le prix d’un plan se trouve sur la page tarifs ; les questions pratiques sont dans le centre d’aide.