Étage 01 · Logiciel
Intégration API. Vos systèmes se parlent.
L’intégration API consiste à relier votre site, vos applis et les services en ligne dont ils dépendent (paiement, réservation, cartes, e-mail, modèles d’IA) pour que les données circulent seules de l’un à l’autre. Depuis Tallinn, yop construit et maintient ces intégrations, avec supervision et journaux, et le code, les clés et les comptes restent à votre nom.
Intégrations
Que comprend une intégration ?
Elle permet à deux systèmes d’échanger des données sans personne au milieu : un paiement validé confirme la réservation, une inscription sur le site arrive dans l’outil d’e-mailing, le statut d’un colis s’affiche dans le compte client. Le travail tient moins au code qu’aux détails : quel système fait foi, comment les champs se correspondent, ce qui se passe quand un côté tombe en panne.
Nous construisons des intégrations sur des API REST et GraphQL, des webhooks et, si besoin, d’anciennes interfaces SOAP ou par fichiers. Chacune a ses journaux, ses relances et ses alertes : une synchro ratée se voit en quelques minutes, pas en fin de mois.
Les intégrations internes aux logiciels de gestion (comptabilité, facturation électronique, places de marché) sont confiées à notre société sœur pirdir.
- Paiements. Stripe, PayPal, Klarna et prestataires locaux reliés au paiement, aux abonnements et aux remboursements.
- Site et applis. Comptes, formulaires et contenus partagés entre votre site, votre appli et votre propre API.
- Services tiers. Cartes, réservation, messagerie, e-mail et API d’IA branchés sur votre produit.
- Boutiques en ligne. Produits, stocks et commandes synchronisés entre votre boutique et les services qui l’entourent.
Ce qu’on relie
Les liens les plus courants.
Paiements et abonnements
Paiement, prélèvements récurrents, remboursements et statuts tenus à jour sur votre site ou votre appli.
Boutiques en ligne
Commandes, stocks et prix synchronisés avec les services autour de la boutique, à heure fixe ou en temps réel.
Back-end site et appli
Votre site et votre appli mobile lisent et écrivent les mêmes données via une seule API.
API tierces
Cartes, réservation, messagerie, e-mail et services d’IA ajoutés à votre produit, clés stockées en sécurité.
Webhooks et événements
Mises à jour instantanées entre services à chaque événement, avec relance si un appel échoue.
Votre API
Une API claire et documentée pour votre logiciel, prête pour vos partenaires et vos futurs outils.
Test de panne
Un service tombe, rien ne se perd.
Une commande payée part du prestataire de paiement vers votre boutique. Choisissez la panne et voyez comment l’intégration répond.
Illustration. Les délais et limites réels suivent les règles de chaque prestataire.
Caisse · commande #1042
2 × mélange maison, 250 g
38,00 € · payé par carte
- vérif. signature
- relance
- anti-doublon
- file
- adaptateur
integration.logtail -f
- 09:58:00INFOworker actif · écoute /webhooks/payment
- 09:58:00INFOroutes : /orders vers la boutique · /receipts vers le mail
- 09:58:00INFOrelances : 5 essais, espacés de 30 s à 30 min
- 09:58:01OKsanté · boutique 200 · mail 200
- 09:58:01INFOfile vide · alertes vers l’astreinte
- 10:42:07INpayment.paid #1042 · clé pay_1042
- 10:42:07OKsignature vérifiée · nouvelle clé
- 10:42:07200POST /orders/1042/paid · 86 ms
- 10:42:07202POST /receipts #1042 · 47 ms
- 10:42:07200réponse envoyée · 140 ms au total
- 10:44:12INpayment.paid #1043 · clé pay_1043
- 10:44:22504POST /orders/1043/paid · sans réponse en 10 s
- 10:44:52RETRYessai 2 sur 5 après 30 s · 504
- 10:46:52RETRYessai 3 sur 5 après 2 min
- 10:46:52200POST /orders/1043/paid · 310 ms · payé
- 10:51:30INpayment.paid #1044 · clé pay_1044
- 10:51:30200POST /orders/1044/paid · 92 ms
- 10:51:33INpayment.paid #1044 · clé pay_1044 encore
- 10:51:33SKIPclé pay_1044 déjà traitée · pas de 2e commande
- 10:51:33200réponse envoyée · une commande, un mail
- 11:03:15INpayment.paid #1045 · clé pay_1045
- 11:03:15200POST /orders/1045/paid · 88 ms
- 11:03:15503POST /receipts #1045 · service mail HS
- 11:03:15QUEUEreçu #1045 retenu · 3 en file · relance toutes les 60 s
- 11:03:16ALERTastreinte prévenue : mail HS depuis 11:01
- 11:20:02WARNboutique : Sunset le 31 mars 2027 pour l’API v1
- 11:20:02INFOv2 renomme « amount » en « total »
- 11:21:40TESTadaptateur v2 en préprod · 48 sur 48 OK
- 11:22:05200POST /v2/orders/1046/paid · 95 ms
- 11:22:05OKpassé en v2 avant le retrait de v1
Normal : payé, enregistré, mail envoyé en moins d’une seconde
Vocabulaire
Six termes à connaître.
- Bac à sable
- Une copie de test d’un service où paiements et messages sont fictifs, pour tout essayer sans risque.
- Idempotence
- Une même requête envoyée deux fois ne produit qu’un effet : pas de double commande ni de double débit.
- Limite de débit
- Le nombre d’appels qu’une API accepte par période. L’intégration espace ses appels pour rester sous ce seuil.
- OAuth
- Une méthode standard pour qu’une appli obtienne un accès limité à un autre compte sans jamais voir son mot de passe.
- Source de vérité
- Le seul système dont la valeur l’emporte quand deux systèmes divergent sur un même champ.
- Webhook
- Un message qu’un service envoie à un autre dès qu’un événement se produit, comme un paiement validé.
Comparer
Intégration sur mesure ou connecteur API ?
| Une intégration sur mesure comparée à un connecteur API tout prêt | Intégration sur mesureNotre choix | Connecteur tout prêt |
|---|---|---|
| Suit vos données et règles | Oui | Selon ses réglages |
| Supervision et alertes | Intégrées | Variable |
| Coût mensuel | Hébergement seul | Par connecteur ou par tâche |
| Gestion des exceptions | Comme vous le décidez | Comme l’éditeur le décide |
| Idéal pour | Flux clés, gros volumes, règles spéciales | Liens simples, standard |
La méthode
Quatre étapes vers des flux fiables.
Carte
Chaque système, champ et règle décrit par écrit, avec le système qui détient la version de référence.
Code
Connecteurs construits sur des comptes de test, avec journaux, relances et alertes.
Test
Cas réels testés de bout en bout, délicats compris : doublons, remboursements, délais dépassés.
Suivi
Mise en ligne, supervision et correctif quand un éditeur change d’API.
Prix
Ce qui fait le prix d’une intégration.
Deux systèmes avec de bonnes API, c’est le cas simple. Voici ce qui ajoute du travail.
Nombre de systèmes
Chaque système de plus apporte ses champs, limites, comptes de test et modes de panne.
Vieux systèmes
SOAP, dépôts de fichiers et accès direct à la base demandent plus de soin qu’une API REST récente.
Temps réel ou planifié
Les webhooks demandent file et relances ; une synchro nocturne est plus simple à bâtir et à suivre.
Cas particuliers
Remboursements partiels, envois fractionnés et arrondis de devises prennent l’essentiel du temps de test.
Volumétrie
Un gros volume impose pagination et cadence, mais change rarement la conception.
Supervision
Journaux, alertes et responsable nommé toujours inclus ; tableau de bord dédié en option.
Maintenance
Et quand une API change ?
Les API évoluent : nouvelles versions, anciens champs retirés, limites modifiées. Chaque intégration de yop a ses journaux et ses alertes, et nous suivons les annonces des API que nous maintenons : la mise à jour est planifiée avant que l’ancienne version s’arrête.
La maintenance peut se faire à prix mensuel fixe, ou votre équipe peut la reprendre avec la documentation que nous lui remettons.
Vos systèmes
Listez vos outils, on dessine les liens.
Dites-nous quels systèmes vous utilisez et où vos équipes ressaisissent des données de l’un à l’autre. Réponse sous deux jours ouvrés, avec une carte des flux.
Questions
Vos questions sur les API.
Qu’est-ce qu’une intégration API ?
Une intégration API relie entre eux les logiciels d’une entreprise par leurs API, pour que les données passent d’un système à l’autre sans copie à la main. yop cartographie les données, construit les connexions, les surveille et les maintient quand les API changent.
Combien coûte une intégration ?
Chez yop, une intégration se facture à prix fixe par phase, après cartographie des systèmes et des données. Nombre de systèmes, volume de données et complexité des règles fixent le périmètre.
Combien de temps prend une intégration ?
Entre deux systèmes dotés de bonnes API, une liaison tourne souvent en quelques semaines. Anciens systèmes, règles nombreuses ou plusieurs pays allongent le délai.
Pouvez-vous intégrer un ancien système sans API ?
Souvent, oui : accès à la base de données, échange de fichiers ou petite couche d’API devant l’ancien système, selon ce qui est stable et autorisé.
Quels systèmes pouvez-vous intégrer ?
Sites, applis mobiles, paiements, boutiques en ligne, réservation, messagerie, e-mailing, modèles d’IA et la plupart des outils SaaS à API documentée. Pour une intégration ERP, nous relions votre ERP existant au site ou à la boutique.
Comment fiabiliser une intégration ?
Chaque intégration a ses journaux, relances et alertes, et un responsable par champ de données. Une synchro ratée est signalée en quelques minutes et corrigée avant que quiconque le remarque.
À qui appartiennent le code et les clés d’API ?
À vous. Code, identifiants et comptes fournisseurs sont à votre nom et documentés : une autre équipe peut prendre le relais.
Étage 01 · Logiciel
Plus à l’étage Logiciel
Logiciels sur mesure, SaaS, applis et IA, qui appartiennent à votre entreprise.
Un logiciel taillé pour votre façon de travailler.
Des produits par abonnement avec comptes, offres et facturation.
Le plus petit vrai produit, testé par des utilisateurs payants.
Des applis iOS et Android que l’on garde sur son écran d’accueil.
Les chiffres et les écrans que votre équipe ouvre chaque matin.
Back-office, généalogie et commissions, construits pour votre plan.
L’IA et l’automatisation dans vos outils actuels.