Créez des applications pour les entreprises qui utilisent OneBooks
Une API OAuth et MCP, des pages intégrées directement dans OneBooks, des données d’application sur de vrais enregistrements, et des fonctions hébergées — touchez toutes les entreprises OneBooks via une seule fiche validée dans le Marketplace.
Quatre façons d’étendre OneBooks
API OAuth et webhooks
Une API REST OAuth 2.0 à portées sur les factures, paiements, clients, rapports et plus, ainsi que MCP pour les agents IA. Recevez plus de 40 événements par webhook ou via l’API d’événements — avec des écritures idempotentes, des versions datées et une documentation de référence complète.
Des applications dans OneBooks
Vos propres pages dans OneBooks, plus des actions et des cartes à 15 emplacements — le tableau de bord et sept types de fiches, des factures aux retours d’achat — dans un cadre isolé, authentifiées par des jetons de session de courte durée.
Données d’application sur les fiches
Stockez vos propres champs typés sur 12 types de fiches — clients, factures, articles et plus — visibles par le commerçant directement sur la fiche, là où il travaille déjà.
Fonctions hébergées
Exécutez votre code sur les événements, dans un environnement isolé sur l’infrastructure de OneBooks. Il ne peut joindre que les destinations que vous déclarez — sans serveur à exploiter pour de simples automatisations.
De la page intégrée aux données comptables
App Bridge remet à votre page intégrée un jeton de session de courte durée. Votre serveur l’échange contre un jeton d’accès — ensuite, c’est un appel d’API ordinaire. Sans redirection, et sans SDK obligatoire.
Lire le guide de l’échange de jetons (s’ouvre dans un nouvel onglet)
curl -X POST https://api.getonebooks.com/oauth/token \
-u "YOUR_CLIENT_ID:YOUR_CLIENT_SECRET" \
-d grant_type=urn:ietf:params:oauth:grant-type:token-exchange \
-d subject_token=SESSION_TOKEN \
-d subject_token_type=urn:ietf:params:oauth:token-type:jwtcurl https://api.getonebooks.com/invoices \
-H "Authorization: Bearer ACCESS_TOKEN"Conçu pour les développeurs qui livrent
- ✓ Chaque formule — y compris la formule gratuite — inclut l’accès à l’API, donc tout commerce peut installer votre application
- ✓ Cinq langues dont l’arabe, entièrement de droite à gauche
- ✓ Une fiche validée dans le Marketplace, avec une diffusion au sein de l’application que chaque commerce utilise déjà
- ✓ Des entreprises sandbox gratuites pour construire et tester, sans risque pour une comptabilité réelle
- ✓ Vous facturez vos clients directement et conservez 100 % de vos revenus
- ✓ Des limites de débit par application et par entreprise : le trafic des autres applications n’entame jamais le vôtre
- ✓ Un versionnage de l’API par date, avec 12 mois de support après chaque nouvelle version
De l’idée au Marketplace
- 01
Créer un compte développeur
Inscrivez-vous sur la console développeur — c’est gratuit, et ça prend quelques minutes.
- 02
Développer dans un sandbox
Enregistrez votre application et développez sur des entreprises sandbox gratuites, sans risque pour la comptabilité réelle de qui que ce soit.
- 03
Passer la revue d’application
Tant qu’elle n’est pas approuvée, votre application ne peut se connecter qu’à vos propres sandbox. La revue d’application la vérifie avant que de vraies entreprises puissent l’utiliser.
- 04
Passer la revue de la fiche
Soumettez votre fiche pour le Marketplace. Une fois approuvée par la revue de la fiche, elle est publiée — et toutes les entreprises OneBooks peuvent trouver et installer votre application.
Le moindre privilège, par défaut
- ✓ Les pages intégrées s’exécutent dans des iframes isolées d’origine croisée, authentifiées par des jetons de session de courte durée — jamais un cookie partagé
- ✓ Chaque installation est limitée exactement aux permissions qu’elle demande, consenties par le commerce, et rien de plus
- ✓ Les fonctions hébergées s’exécutent dans des workers isolés avec une liste déclarée et appliquée des destinations accessibles
- ✓ Chaque écriture effectuée par votre application lui est attribuée dans le journal d’audit du commerce
- ✓ Les commerces peuvent désinstaller votre application à tout moment — l’accès prend fin immédiatement, partout
Avancez plus vite avec les outils officiels
App Bridge
La bibliothèque navigateur pour les pages intégrées : jetons de session, navigation, notifications, sélecteurs et boîtes de dialogue de confirmation.
SDK Node
Un client serveur typé pour l’API OAuth, avec nouvelles tentatives, échange de jetons et vérification des jetons de session et des webhooks.
SDK Functions
Des types pour écrire des fonctions hébergées, et un exécuteur local pour les tester avant de les déployer.
CLI
Générez la structure d’une application, déployez et testez des fonctions hébergées sur un sandbox, et publiez de nouvelles versions depuis votre terminal.
Modèle de démarrage
Une application intégrée prête à l’emploi que la CLI génère pour vous — OAuth, App Bridge, une action et une carte sur la facture, un récepteur de webhooks et une fonction hébergée d’exemple, déjà connectés.
Les SDK et la CLI sont en préversion : installez-les depuis les sources en attendant leur publication sur npm.
Votre application, devant chaque commerce OneBooks.
Créez un compte développeur gratuit, construisez contre un sandbox, et publiez sur un Marketplace auquel les commerces font déjà confiance.