Qu'est-ce que c'est
Alors qu'il existe de nombreux avantages aux API RESTful, un inconvénient est qu'en cas d'appel infructueux, il n'y a par défaut aucun souvenir de la tentative échouée. Pour les intégrations d'API système-système, en particulier dans le domaine de la santé, cela peut être dangereux car cela pourrait entraîner une perte d'informations et des perturbations des processus entre les systèmes.
Pour remédier à ce problème, Ocean dispose d'une capacité de réessai automatisée intégrée pour toutes les intégrations d'API Ocean directes et basées sur FHIR. Ce service Ocean renverra toutes les notifications de webhook qui ne reçoivent pas un code de statut de classe 20X (par exemple 200, 201) une fois par heure pendant jusqu'à quatre jours.
Comment ça fonctionne
Ce service sera exploité à partir du module Ocean Cloud Connect. Cloud Connect gère une file d'attente de toutes les notifications de webhook qui y sont acheminées jusqu'à ce qu'elles réussissent ou expirent.
- Les appels réussis sont retirés de la file d'attente.
-
- Le premier appel d'API infructueux déclenchera une alerte par e-mail contenant le nom de l'intégration et le message d'erreur rencontré par Ocean, qui sera envoyé par e-mail à l'adresse e-mail du 'Administrateur clinique / Contact de support Ocean' spécifiée dans les paramètres du compte du site.
-
- Ocean réessayera l'appel à l'endpoint plusieurs fois dans la première heure. En cas d'échec, Ocean réessaiera une fois par heure.
-
- Toutes les 24 heures, Ocean enverra une alerte par e-mail au 'Administrateur clinique / Contact de support Ocean' pour les informer que les problèmes ne sont toujours pas résolus.
-
- Si l'événement d'API en échec est envoyé avec succès pendant la période de réessai, les alertes par e-mail quotidiennes cesseront.
-
- Au bout de 96 heures, Ocean abandonnera les tentatives de joindre l'endpoint. Cependant, Ocean continuera d'envoyer des e-mails quotidiens au 'Administrateur clinique / Contact de support Ocean' tant que l'intégration n'aura pas envoyé un événement réussi.
-
- Une fois que l'intégration reçoit et accepte un message réussi d'Ocean, ou si les paramètres d'intégration sont sauvegardés à nouveau dans Ocean après la fin des tentatives de réessai, les notifications par e-mail quotidiennes cesseront.
Ce que vous devez faire
- Assurez-vous que l'adresse électronique (ou les adresses électroniques) de la ou des personnes les plus responsables de l'intégration est/sont incluses dans le champ 'Administrateur clinique / Personne-ressource de soutien Ocean' du site Ocean. Il peut s'agir du gestionnaire informatique de la clinique et/ou du point de contact du fournisseur; ils n'ont pas besoin d'être un utilisateur sur le site Ocean.
- Plusieurs adresses électroniques peuvent être spécifiées dans le champ - il suffit de séparer chaque adresse électronique par une virgule.
- Lorsqu'une alerte par courriel est reçue de la part d'Ocean, cela indique généralement un problème avec le point de terminaison du système récepteur, pas avec Ocean. La première étape à suivre est d'examiner la santé du point de terminaison du système récepteur avant de contacter l'équipe de soutien d'OceanMD.
- Les problèmes courants rencontrés comprennent:
- Certificats expirés.
- Temps d'arrêt du système non planifié.
- Le point de terminaison du système récepteur ne sait pas comment traiter le message qu'il a reçu.
- Si de l'aide est nécessaire ou s'il semble s'agir d'un problème lié à Ocean, veuillez soumettre un rapport d'incident à l'équipe de soutien OceanMD. Dans votre rapport, assurez-vous d'inclure:
- Numéro du site Ocean
- Environnement Ocean (par exemple, test.cognisantmd.com, staging.cognisantmd.com ou ocean.cognisantmd.com)
- Une description de l'enquête effectuée jusqu'à présent pour évaluer tout problème avec le point de terminaison récepteur.
- Une capture d'écran complète de l'alerte par courriel Ocean incluant la date et l'heure de réception du courriel.