Le verdict en trois phrases
Les dérapages d'un projet d'intégration ne viennent presque jamais du code, mais d'un cahier des charges flou. En 2026, un CDC précis fait tomber les avenants de plus de 30 % à moins de 10 % et divise par deux les écarts de devis entre prestataires. Documentez six choses : contrats d'API, authentification, mode de communication, idempotence, gestion d'erreurs et SLA de disponibilité.
Les exigences à documenter
Chaque exigence non spécifiée devient un avenant. Voici les points qui font varier le prix et qu'il faut trancher avant consultation.
| Exigence | À spécifier | Impact si oublié |
|---|---|---|
| Contrat d'API | OpenAPI/Swagger fourni | +20-40 % de reverse engineering |
| Authentification | OAuth2, clé API, rotation | Failles + retard |
| Communication | Webhooks vs polling | Latence non maîtrisée |
| Idempotence | Clé d'idempotence, dédup | Doublons en production |
| Gestion d'erreurs | Retries, backoff, DLQ | Pertes de données |
| Quotas / rate limits | Seuils, throttling | Blocages API tierce |
Un CDC qui fournit les specs OpenAPI des API concernées 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 intégration fiable tient en trois notions : recevoir les événements (webhooks ou polling), ne pas les traiter deux fois (idempotence) et garantir un niveau de service (SLA).
| Paramètre | Option A | Option B | Recommandation 2026 |
|---|---|---|---|
| Réception | Polling (interroger) | Webhooks (être notifié) | Webhooks si temps réel |
| Doublons | Aucun contrôle | Clé d'idempotence | Clé obligatoire |
| Échecs | Abandon | Retries + backoff | 3-5 retries + DLQ |
| Disponibilité flux | 99,0 % | 99,5-99,9 % | 99,5 % mini contractuel |
| Monitoring | Aucun | Alertes + dashboard | Alerte < 5 min |
Un SLA de disponibilité des flux de 99,5 % autorise environ 3,6 h d'indisponibilité par mois ; 99,9 % descend à 43 minutes. Chaque neuf supplémentaire coûte cher, il faut donc le calibrer sur la criticité réelle.
La matrice de flux, socle du CDC
Le livrable central d'un CDC d'intégration est une matrice qui liste chaque flux : source, destination, fréquence, volume et criticité. Elle sert à 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 | Fréquence | Volume/mois | Criticité |
|---|---|---|---|---|
| Commandes | Site -> ERP | Temps réel | 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 critères de recette : cas nominal, cas d'erreur, rejeu, et volumétrie de charge testée.
Mini cas pratique
Sarah, chef de projet SI dans une PME de distribution à Nice, prépare une consultation pour 6 intégrations. Sans CDC, ses trois premiers devis oscillaient entre 14 000 et 34 000 EUR HT, un écart ingérable. Elle formalise une matrice de flux, fournit les specs OpenAPI et fixe un SLA de 99,5 %. Résultat : les nouveaux devis se resserrent entre 19 000 et 24 000 EUR HT et le budget d'avenants passe d'une provision de 30 % à 8 %. Sur un projet à 21 000 EUR, elle économise environ 4 600 EUR d'avenants évités.
FAQ
Qu'est-ce qu'une clé d'idempotence ? C'est un identifiant unique attaché à chaque requête pour garantir qu'un même événement (ex. une commande) n'est traité qu'une fois, même s'il est renvoyé. Sans elle, un retry crée des doublons en production.
Webhooks ou polling ? Les webhooks notifient en temps réel (latence < 30 s) et sont à privilégier pour le stock ou les paiements ; le polling interroge périodiquement et suffit pour des données peu urgentes. Le mauvais choix se paie en latence ou en surcoût serveur.
Quel SLA de disponibilité spécifier ? 99,5 % est un bon minimum contractuel pour des flux B2B (soit ~3,6 h d'arrêt/mois). Passer à 99,9 % (43 min/mois) renforce le coût d'infrastructure et de monitoring, à réserver aux flux critiques.
Un CDC précis fait-il vraiment baisser le prix ? Il ne baisse pas le coût réel, mais il élimine la prime de risque que les prestataires ajoutent face à l'inconnu. C'est ainsi que les écarts de devis sont divisés par deux et les avenants réduits sous 10 %.
Que mettre dans les critères de recette ? Pour chaque flux : le cas nominal, les cas d'erreur (API tierce indisponible, donnée invalide), le rejeu après panne et un test de charge à la volumétrie cible. Sans recette formelle, les bugs se découvrent en production.
Parlons de votre projet. Envoyez-nous votre liste de flux (source, destination, volume, criticité) et vos contraintes de SLA : nous vous aidons à formaliser le CDC et à chiffrer. Devis détaillé 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.
