OAuth 2.0 · MCP
Développeurs

Connectez tous vos systèmes à OneBooks.

Une API OAuth 2.0 fondée sur les standards, avec jetons à portée limitée et webhooks, plus MCP pour les agents IA — le socle de la plateforme développeur OneBooks. Synchronisez votre système ou construisez un agent ici, puis allez plus loin avec des applications qui fonctionnent dans OneBooks et une fiche dans le Marketplace.

Voir ce que voient les commerçants

OAuth 2.0 + PKCE

code d’autorisation, rotation des jetons, enregistrement dynamique, flux appareil

Jetons à portée limitée

portées de lecture et d’écriture par domaine — factures, paiements, rapports…

Toutes les formules

accès à l’API et à MCP dans toutes les formules OneBooks, y compris la formule gratuite

Comment ça marche

De la console à vos clients.

01

Enregistrer votre application

Créez-la dans la console développeur et développez sur des entreprises sandbox gratuites.

02

Développer

OAuth 2.0 standard avec PKCE et portées ; des endpoints documentés pour les documents, les paiements et les rapports ; des webhooks pour ce qui change ; MCP si vous construisez un agent.

03

Mettre en ligne

Passez la revue d’application et votre application peut se connecter à n’importe quelle entreprise OneBooks. Pour figurer dans le Marketplace, soumettez une fiche à sa propre revue.

L’API

Des standards, pas des surprises.

Si vous avez déjà intégré un fournisseur OAuth moderne, vous savez déjà comment cela fonctionne.

  • ✓ OAuth 2.0 — code d’autorisation avec PKCE, rotation des jetons de rafraîchissement, enregistrement dynamique RFC 7591, flux appareil RFC 8628 pour les applications natives, découverte RFC 8414 / 9728.
  • ✓ Des portées par domaine — factures, paiements, achats, rapports et plus encore, en lecture ou en écriture, autorisées entreprise par entreprise.
  • ✓ Idempotence partout — chaque écriture financière accepte une clé d’idempotence : les nouvelles tentatives sont sans risque.
  • ✓ Webhooks et API d’événements — des livraisons signées avec nouvelles tentatives pour plus de 40 événements, et un journal d’événements pour rattraper ce que vous avez manqué.
  • ✓ Versions d’API datées — figez la version sur laquelle vous avez développé ; chacune reste prise en charge 12 mois après l’arrivée de la suivante.
  • ✓ MCP pour les agents — la même surface d’autorisation expose des outils typés aux agents IA, avec des écritures confirmées par un humain.
La plateforme d’applications

Au-delà de l’API.

L’API n’est qu’une partie de la plateforme développeur OneBooks. Quand une intégration ne suffit pas, créez une application que les commerces utilisent dans OneBooks.

  • ✓ Des applications dans OneBooks — vos propres pages, des actions dans le menu Applications d’une fiche et des cartes sur les fiches et le tableau de bord, dans un cadre isolé avec des jetons de session de courte durée.
  • ✓ Des données d’application sur les fiches — vos propres champs typés sur les factures, les clients, les articles et neuf autres types de fiches.
  • ✓ Des fonctions hébergées — votre code s’exécute sur les événements dans un environnement isolé qui ne peut joindre que les destinations que vous déclarez.
  • ✓ Le Marketplace d’applications — passez la revue de la fiche et toutes les entreprises OneBooks peuvent trouver et installer votre application ; vous facturez vos clients directement et conservez 100 % de ce que vous facturez.
  • ✓ Entreprises sandbox — développez et testez sans toucher à de vrais livres.

API OneBooks — questions fréquentes

Quelle authentification l’API utilise-t-elle ?

OAuth 2.0 — code d’autorisation avec PKCE pour les applications, enregistrement dynamique des clients pour les intégrations en libre-service, flux appareil pour les applications natives sans redirection, et rotation des jetons de rafraîchissement partout.

Existe-t-il un sandbox ?

Oui — la console développeur provisionne des entreprises sandbox pour développer et tester sur des livres réalistes sans toucher aux données d’un client.

Quelles formules OneBooks peuvent connecter mon application ?

Toutes. L’accès à l’API et à MCP est inclus dans toutes les formules, y compris la formule gratuite : n’importe quelle entreprise OneBooks peut donc connecter votre application.

Ai-je besoin d’une fiche dans le Marketplace ?

Non. C’est la revue d’application qui permet à votre application de se connecter à de vraies entreprises. La fiche dans le Marketplace est facultative et fait l’objet de sa propre revue avant publication.

Puis-je construire un agent IA dessus ?

Oui — OneBooks expose un serveur MCP sur la même surface OAuth, avec des outils typés, un accès à portée limitée et des écritures confirmées par un humain.

Mes clients peuvent-ils obtenir OneBooks sans frais ?

Grâce à notre programme partenaires, les éditeurs de caisses et de plateformes peuvent offrir à leurs clients vérifiés la formule Standard de OneBooks sans frais. Présentez-nous votre produit sur la page Devenir partenaire.

Également dans cette catégorie : Plateforme développeur Intégrations
Développez sur OneBooks

Construisez l’intégration que vos clients réclament.

Créez un compte développeur gratuit, développez sur un sandbox et passez en production après une seule revue.