API de notifications
RDV-Solidarités peut notifier votre système d’information à l’aide de webhooks ou en envoyant des ics par email.
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 https://interconnexions.votre-departement.fr/rdv-solidarites
accepter des requêtes HTTP POST à cette URL.
Certains départements ont développé des solutions sur ces sujets :
pour Outlook
pour Microsoft Dynamics
Du code d’exemple est aussi disponible en C# et en NodeJS.
Démonstration
Dans notre environnement de démonstration, nous pouvons envoyer des notifications sur une URL de test (par exemple https://webhook.site) ou envoyer des emails qui contiennent le contenu brut des notifications envoyées par les requêtes HTTP. Pour cela, contactez-nous !
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 ?
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.
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
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 : https://docs.google.com/file/d/1leeQ1B507eNgi2pWfjaOor8TAtkhv6ao/edit?usp=docslist_api&filetype=mspresentation
Emails et icalendar
En plus des webhooks, RDV-Solidarités peut notifier votre SI en envoyant des emails aux agents.
Last updated