Intégrations, API et responsabilités
Cadrer une connexion à un agenda, une identité ou un système communal avant de l’activer.
Quand utiliser ce guide
Utilisez ce guide avant toute connexion à un agenda, une identité, un outil communal ou un autre système, puis lors de chaque évolution de l’échange.
Résultat attendu
L’intégration doit avoir un propriétaire, une finalité, une source de vérité, un contrat de données, des tests, une surveillance et une procédure de coupure.
Le guide en pratique
Cette référence couvre
À qui s’adresse ce guide
Utilisez ce guide avant toute connexion à un agenda, une identité, un outil communal ou un autre système, puis lors de chaque évolution de l’échange.
L’intégration doit avoir un propriétaire, une finalité, une source de vérité, un contrat de données, des tests, une surveillance et une procédure de coupure.
Une intégration est un contrat de fonctionnement
Au-delà de l’API, il faut définir la source de vérité, les données échangées, la fréquence, les erreurs, les doublons, la sécurité et la personne qui intervient lorsque les deux systèmes divergent.
Checklist de cadrage
- Finalité et base légale de l’échange.
- Système source et système destinataire pour chaque donnée.
- Authentification, permissions minimales et rotation des secrets.
- Idempotence, limites de débit et reprise après erreur.
- Environnement de test, recette et possibilité de déconnexion.
Disponibilité réelle
Une route technique, un prototype ou une documentation interne ne constituent pas une intégration supportée. Le connecteur est disponible lorsqu’il figure au périmètre, a été configuré et a passé la recette prévue.
Checklist pratique
- Définir finalité, source de vérité et données échangées.
- Limiter les permissions et préparer la rotation des accès.
- Tester doublons, erreurs, reprise et désactivation.
- Nommer les responsables de chaque système.
Points de contrôle
- Documentez les données, le sens des flux, la fréquence, les identifiants, les erreurs et les responsabilités.
- Testez les doublons, retards, indisponibilités, retraits d’accès et reprises avant la production.
- Limitez les autorisations et prévoyez leur rotation ou révocation.
Erreurs fréquentes à éviter
- Activer un connecteur avec un compte personnel ou des droits globaux inutiles.
- Supposer qu’une intégration mentionnée est disponible pour votre contrat ou environnement.
- Masquer un échec d’échange en corrigeant manuellement sans conserver la trace nécessaire.
Quand demander de l’aide
En cas d’anomalie, isolez le flux si possible, conservez les références techniques et protégez les secrets. Les propriétaires des deux systèmes doivent coordonner le diagnostic et la reprise.
Réponses rapides
Questions propres à ce guide
Une API suffit-elle pour garantir une intégration ?
Non. Il faut aussi un périmètre supporté, une authentification, des règles de données, une recette et un fonctionnement en cas d’erreur.
Qui corrige une divergence ?
Le partage des responsabilités doit être défini avant activation ; l’organisation pilote la source métier et chaque fournisseur intervient sur son composant.
Dernière mise à jour : 30 août 2026 · Responsable : équipe produit Urgentis
Une étape est imprécise ou un cas manque ? Signaler une amélioration. N’ajoutez aucune donnée personnelle ou médicale au message.