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 et les absences.

Pour cela, ce système d'informations doit :

Certains départements ont développé des solutions sur ces sujets :

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, plages d’ouvertures et absences sont envoyées 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.