Le verdict en trois phrases
Les derapages d'un projet d'integration ne viennent presque jamais du code, mais d'un cahier des charges flou. En 2026, un CDC precis fait tomber les avenants de plus de 30 % a moins de 10 % et divise par deux les ecarts de devis entre prestataires. Documentez six choses : contrats d'API, authentification, mode de communication, idempotence, gestion d'erreurs et SLA de disponibilite.
Les exigences a documenter
Chaque exigence non specifiee devient un avenant. Voici les points qui font varier le prix et qu'il faut trancher avant consultation.
| Exigence | A specifier | Impact si oublie |
|---|---|---|
| Contrat d'API | OpenAPI/Swagger fourni | +20-40 % de reverse engineering |
| Authentification | OAuth2, cle API, rotation | Failles + retard |
| Communication | Webhooks vs polling | Latence non maitrisee |
| Idempotence | Cle d'idempotence, dedup | Doublons en production |
| Gestion d'erreurs | Retries, backoff, DLQ | Pertes de donnees |
| Quotas / rate limits | Seuils, throttling | Blocages API tierce |
Un CDC qui fournit les specs OpenAPI des API concernees permet aux prestataires de chiffrer juste, au lieu de gonfler le devis pour couvrir l'inconnu.
Webhooks, idempotence et SLA
Le coeur technique d'une integration fiable tient en trois notions : recevoir les evenements (webhooks ou polling), ne pas les traiter deux fois (idempotence) et garantir un niveau de service (SLA).
| Parametre | Option A | Option B | Recommandation 2026 |
|---|---|---|---|
| Reception | Polling (interroger) | Webhooks (etre notifie) | Webhooks si temps reel |
| Doublons | Aucun controle | Cle d'idempotence | Cle obligatoire |
| Echecs | Abandon | Retries + backoff | 3-5 retries + DLQ |
| Disponibilite flux | 99,0 % | 99,5-99,9 % | 99,5 % mini contractuel |
| Monitoring | Aucun | Alertes + dashboard | Alerte < 5 min |
Un SLA de disponibilite des flux de 99,5 % autorise environ 3,6 h d'indisponibilite par mois ; 99,9 % descend a 43 minutes. Chaque neuf supplementaire coute cher, il faut donc le calibrer sur la criticite reelle.
La matrice de flux, socle du CDC
Le livrable central d'un CDC d'integration est une matrice qui liste chaque flux : source, destination, frequence, volume et criticite. Elle sert a chiffrer, prioriser et recetter.
Besoin d'un site web professionnel ?
Kolonell crée des sites web qui attirent des clients, optimisés pour le marché sénégalais. Devis gratuit en 2 minutes.
| Flux | Source -> Destination | Frequence | Volume/mois | Criticite |
|---|---|---|---|---|
| Commandes | Site -> ERP | Temps reel | 3 000 | Haute |
| Stock | ERP -> Site | 15 min | 20 000 | Haute |
| Contacts | CRM -> App | Nocturne | 5 000 | Moyenne |
| Factures | ERP -> Compta | Nocturne | 3 000 | Moyenne |
| Logs | App -> SIEM | Continu | 200 000 | Basse |
Chaque ligne s'accompagne de criteres de recette : cas nominal, cas d'erreur, rejeu, et volumetrie de charge testee.
Mini cas pratique
Sarah, chef de projet SI dans une PME de distribution a Nice, prepare une consultation pour 6 integrations. Sans CDC, ses trois premiers devis oscillaient entre 14 000 et 34 000 EUR HT, un ecart ingerable. Elle formalise une matrice de flux, fournit les specs OpenAPI et fixe un SLA de 99,5 %. Resultat : les nouveaux devis se resserrent entre 19 000 et 24 000 EUR HT et le budget d'avenants passe d'une provision de 30 % a 8 %. Sur un projet a 21 000 EUR, elle economise environ 4 600 EUR d'avenants evites.
FAQ
Qu'est-ce qu'une cle d'idempotence ? C'est un identifiant unique attache a chaque requete pour garantir qu'un meme evenement (ex. une commande) n'est traite qu'une fois, meme s'il est renvoye. Sans elle, un retry cree des doublons en production.
Webhooks ou polling ? Les webhooks notifient en temps reel (latence < 30 s) et sont a privilegier pour le stock ou les paiements ; le polling interroge periodiquement et suffit pour des donnees peu urgentes. Le mauvais choix se paie en latence ou en surcout serveur.
Quel SLA de disponibilite specifier ? 99,5 % est un bon minimum contractuel pour des flux B2B (soit ~3,6 h d'arret/mois). Passer a 99,9 % (43 min/mois) renforce le cout d'infrastructure et de monitoring, a reserver aux flux critiques.
Un CDC precis fait-il vraiment baisser le prix ? Il ne baisse pas le cout reel, mais il elimine la prime de risque que les prestataires ajoutent face a l'inconnu. C'est ainsi que les ecarts de devis sont divises par deux et les avenants reduits sous 10 %.
Que mettre dans les criteres de recette ? Pour chaque flux : le cas nominal, les cas d'erreur (API tierce indisponible, donnee invalide), le rejeu apres panne et un test de charge a la volumetrie cible. Sans recette formelle, les bugs se decouvrent en production.
Parlons de votre projet. Envoyez-nous votre liste de flux (source, destination, volume, criticite) et vos contraintes de SLA : nous vous aidons a formaliser le CDC et a chiffrer. Devis detaille sous 48 h. WhatsApp +221 77 596 93 33.
Mohamed Bah
Fondateur, Kolonell
Passionné par le digital et l'entrepreneuriat en Afrique, Mohamed accompagne les entreprises sénégalaises dans leur transformation digitale depuis 2020. Fondateur de Kolonell, il croit que chaque PME mérite une présence en ligne professionnelle et accessible.
