API publique en production

Une API REST
sur votre ERP de bureau

EBP et Sage n'exposent rien au web. Synkrone s'installe entre les deux et ouvre vos clients, votre catalogue et vos documents derrière une API REST — avec des webhooks pour être prévenu quand quelque chose change.

Ce que l'API expose

Une quarantaine de points d'entrée, en lecture et en écriture, sur les données que votre ERP tient déjà.

Clients et contacts

Lire et écrire vos clients, leurs contacts et leurs adresses de livraison.

Catalogue

Produits, familles, unités, taux de TVA, et le stock à la demande.

Documents

Devis, commandes et factures. Transférer une commande dans la chaîne documentaire.

Brouillons et paniers

Préparer une vente, la modifier ligne à ligne, puis la soumettre dans l’ERP.

CRM

Activités, appels, rendez-vous et opportunités, avec leur étape dans le pipeline.

Référentiels

Modes de règlement, modes d’expédition, souches de documents, familles.

S'authentifier

Une clé API, passée en en-tête. Rien d'autre à mettre en place.

curl https://api.synkrone.io/api/public/v1/customers \
  -H "Authorization: Bearer sk_live_..."

Des clés qui ne peuvent pas tout

Chaque clé porte des portées explicites — lire le catalogue, écrire les clients, accéder au CRM. Une intégration qui n'a besoin que de lire vos produits reçoit une clé qui ne sait faire que ça. Et une clé reste rattachée à un seul espace : elle ne peut jamais atteindre les données d'un autre.

Être prévenu, plutôt que demander

Interroger l'API toutes les cinq minutes pour savoir si un client a changé, c'est du gâchis. Les webhooks vous préviennent au moment où ça se produit.

Événement Déclenché quand
customer.created Un client a été créé
customer.updated Une fiche client a changé
contact.created Un contact a été ajouté
contact.updated Un contact a changé
address.created Une adresse a été ajoutée
address.updated Une adresse a changé
product.created Un produit est apparu au catalogue
product.updated Un produit a changé — prix, libellé, stock
document.created Un devis, une commande ou une facture a été créé
document.transferred Un document a avancé dans la chaîne documentaire

Un envoi qui ne se perd pas

Si votre service est momentanément injoignable, l'envoi est réessayé. Un redémarrage de votre côté ne vous fait pas manquer un événement — c'est ce qui sépare un webhook utilisable d'un webhook décoratif.

À quoi ça sert, concrètement

Alimenter un site e-commerce

Le catalogue et les stocks viennent de l'ERP, les commandes y redescendent. Sans export nocturne ni fichier à recoller.

Brancher un outil métier

Une application de terrain, un configurateur, un outil de devis maison : ils lisent et écrivent dans la même base que votre gestion.

Synchroniser un outil tiers

Un webhook sur customer.updated, et votre outil de support connaît le client avant que vous n'ayez raccroché.

Pour ce que l'API ne prévoit pas

Une API métier couvre les cas courants. Les besoins d'une entreprise, eux, ne sont pas toujours courants.

Dans Administration → API, un constructeur de requêtes vous laisse composer une extraction sur votre propre base : choisir les tables, les colonnes, poser des filtres, relier ce qui doit l'être. Les jointures peuvent être proposées automatiquement, et le SQL produit reste visible avant toute exécution.

Une requête mise au point se conserve, se nomme et se rejoue. C'est la réponse aux questions que personne n'avait anticipées — un champ personnalisé propre à votre métier, un croisement que votre ERP n'affiche pas, une extraction ponctuelle pour laquelle un développement spécifique serait disproportionné.

Lecture seule, par construction

Le générateur ne produit que des requêtes de consultation, avec des paramètres liés. Il ne peut ni modifier, ni supprimer quoi que ce soit dans votre ERP.

Dans votre espace, sur vos données

Une requête reste attachée à votre environnement et à votre ERP. Elle ne franchit pas la frontière vers un autre espace.

Un cas particulier en tête ? Parlons-en →

La référence complète

Chaque point d'entrée, ses paramètres et ses réponses, au format OpenAPI. La documentation est interactive : vous pouvez essayer les appels depuis la page.

Ouvrir la documentation OpenAPI

Les clés API se créent depuis votre espace, dans Administration → API.

Questions fréquentes — API

Sur quoi l'API donne-t-elle accès exactement ? +

Sur les données de votre espace Synkrone, alimenté par votre ERP. Une clé est rattachée à un seul espace et ne peut jamais en atteindre un autre.

Est-ce que l'API écrit dans mon ERP ? +

Oui, pour ce qui est prévu pour : un devis ou une commande créés par l'API redescendent dans EBP ou Sage par les chemins officiels — le SDK pour EBP, les objets métier pour Sage. Le reste est en lecture.

Comment limiter ce qu'une clé peut faire ? +

Chaque clé porte des portées explicites : lecture du catalogue, écriture des clients, accès au CRM… Une clé ne reçoit que ce dont elle a besoin, et les portées se révisent à tout moment.

Que se passe-t-il si mon service est indisponible quand un webhook part ? +

L'envoi est réessayé. Un service momentanément injoignable ne vous fait pas perdre l'événement.

Le constructeur de requêtes peut-il abîmer mes données ? +

Non. Il ne sait produire que des requêtes de consultation, avec des paramètres liés — écrire, modifier ou supprimer lui est impossible par construction, pas par réglage.

Y a-t-il une limite d'appels ? +

Oui, exprimée en requêtes par minute et ajustable selon l'usage. Le profil courant suffit largement à une intégration classique ; dites-nous si vous prévoyez un volume inhabituel.

Prêt à moderniser votre ERP ?

Demandez une démo personnalisée

— ou remplissez le formulaire ci-dessous —

Réponse sous 24h • Sans engagement