# API de notifications RDV-Solidarités peut notifier n'importe quel système d'information accessible en ligne lors de **modifications** (création, modification, suppression) sur les **RDV,** les **plages d'ouvertures**, les **absences** et les **usagers.** Pour cela, ce système d'informations doit : * être accessible à **une URL** publique par exemple * accepter des requêtes HTTP POST à cette URL. Certains départements ont développé des solutions sur ces sujets : * pour [Outlook](https://github.com/rdv-solidarites/rdv-solidarites-doc/blob/master/tech/api-interconnexions-sortantes/broken-reference/README.md) * pour [Microsoft Dynamics](https://github.com/rdv-solidarites/rdv-solidarites-doc/blob/master/tech/api-interconnexions-sortantes/broken-reference/README.md) Du code d’exemple est aussi [disponible en C# et en NodeJS](https://github.com/guillett/webhook). ### Démonstration Dans notre environnement de démonstration, nous pouvons envoyer des notifications sur une URL de test (par exemple ) ou envoyer des emails qui contiennent le contenu brut des notifications envoyées par les requêtes HTTP. Pour cela, [contactez-nous](https://app.gitbook.com/s/-MG9-_JuLUdv0lRqkUMW/guide-pour-un-charge-dinformatique/contact@rdv-solidarites.fr) ! ### Signatures des requêtes Un secret partagé est associé à chacune de ces URLs pour vous permettre de vérifier que nous sommes bien à l'origine de l'envoi d'information. La requête envoyée en HTTP POST contient un entête `X-Lapin-Signature` qui contient une signature SHA256 hexadécimale du corps de la requête. [Comment vérifier la signature ?](https://github.com/rdv-solidarites/rdv-solidarites-doc/blob/master/tech/api-interconnexions-sortantes/broken-reference/README.md) ### Format des données Les RDV, les plages d’ouvertures, les absences et les usagers sont envoyés en json, une requête par évènement de création, modification ou suppression. [Format des données](https://github.com/rdv-solidarites/rdv-solidarites-doc/blob/master/tech/api-interconnexions-sortantes/broken-reference/README.md). ### Tests Il est possible de reproduire un appel fait par RDV-Solidarités vers un SI tiers (ici `http://127.0.0.1:3000`) en mettant le texte donné en exemple ci-dessus dans un fichier `XXXX.json` et d'utiliser la commande suivante ```bash curl 'http://127.0.0.1:3000' --data @XXXX.json -H 'Content-Type: application/json; charset=utf-8' ``` ### Implémentation côté RDV-Solidarités * * Présentation faite aux DSIs : ### Emails et icalendar En plus des webhooks, RDV-Solidarités peut notifier votre SI en [envoyant des emails aux agents](https://github.com/rdv-solidarites/rdv-solidarites-doc/blob/master/tech/api-interconnexions-sortantes/broken-reference/README.md). --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://rdv-solidarites.gitbook.io/guides-pour-rdv-solidarites/tech/api-interconnexions-sortantes.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.