Guides pour RDV-Solidarités
  • Guides et ressources de RDV-Solidarités
  • Les guides d'utilisation
    • Pour les agents
      • Guide d'utilisation pour les agents
        • Compte et connexion
        • Fiches usagers
        • Notifications usagers
        • Notifications agents
        • Interface Agent
        • Status de rendez-vous
        • File d'attente
        • Fusionner les doublons
        • Annulation de Rendez-vous
        • FAQ
      • Comment démarrer sur RDV-solidarités ?
        • Comment se connecter ?
        • Effectuer le paramétrage
          • Votre organisation
          • Vos lieux
          • Vos agents
          • Vos motifs
          • Vos statistiques globales
        • Définir votre planning
          • Créer des plages d’ouverture
          • Créer et gérer les absences
        • Créer votre base d’usagers
          • Comment créer une fiche usager en charge ?
          • Comment créer une fiche usager proche ?
          • Comment consulter l’historique des rendez-vous d’un usager ?
          • Comment rechercher un usager dans la base usager ?
        • comment gérer ses rendez-vous ?
          • Comment accéder au calendrier d’un autre agent ?
          • Comment poser un rendez-vous ?
            • 1. Directement sur l’agenda de l’agent
            • 2. Recherche de tous les créneaux disponibles
          • Comment consulter et modifier le résumé d’un rendez-vous ?
        • RDV Collectifs
        • Comment se déconnecter ?
    • Pour les Conseillers Numériques
    • Pour une organisation
      • Permissions des agents
      • Suppression d'agent
    • Pour un territoire
      • Créer une organisation
      • Configuration Territoire
      • Sectorisation géographique
        • Logique détaillée de la sectorisation
        • Exemple 1 : Par commune et par organisation
        • Exemple 2 : Sectorisation par rue et par agent
  • Documentation Technique
    • Hébergement & sécurité
    • Interconnexions aperçues
    • API de requêtes
      • Généralités
      • Authentification
      • Usagers
      • Agents
      • Organisations
      • Absences
      • Motifs
    • API de notifications
      • Format des données
      • FAQ
      • Vérification de signature
      • Outlook
      • Microsoft Dynamics
      • Interconnexion par email et icalendar
    • Envoi de SMS
    • États de rendez-vous
  • Organisation d'équipe
    • Le rôle de la personne référente
    • Estimations
    • Data.insertion aka RDV-Insertion
    • Gouvernance
    • Réunions Référentes
      • Réunion référentes du 19 avril 2022
      • Réunion référentes du 12 avril 2022
      • Réunion référentes du 5 avril 2022
      • Réunion référentes du 29 mars 2022
      • Réunion référentes du 22 mars 2022
      • Réunion référentes du 15 mars 2022
      • Réunion référentes du 8 mars 2022
      • Atelier RGPD du 7 mars 2022
      • Réunion référentes du 1er mars 2022
      • Atelier RGPD du 24 février 2022
      • Réunion référentes du 22 février 2022
      • Réunion référentes du 15 février 2022
      • Réunion référentes du 8 février 2022
      • Réunion référentes du 1er février 2022
      • Réunion référentes du 25 janvier 2022
      • Réunion référentes du 18 janvier 2022
      • Réunion référentes du 11 janvier 2022
      • Réunion référentes du 4 janvier 2022
      • Réunion référentes du 14 décembre 2021
      • Réunion référentes du 7 décembre 2021
      • Réunion référentes du 30 novembre 2021
      • Réunion référentes du 16 novembre 2021
      • Réunion référentes du 9 novembre 2021
      • Réunion référentes du 2 novembre 2021
      • Atelier RDV Collectif du 29 octobre 2021
      • Réunion référentes du 26 octobre 2021
      • Réunion référentes du 19 octobre 2021
      • Réunion référentes du 12 octobre 2021
      • Réunion référentes du 5 octobre 2021
      • Réunion référentes du 28 septembre 2021
      • Réunion référentes du 21 septembre 2021
      • Réunion Référents du 25 mai 2021
      • Réunion référent.e du 11 mai 2021
      • Réunion référent.e du 4 mai 2021
      • Réunion référente du 27 avril 2021
      • Réunion référentes du 16 mars 2021
      • Réunion référents du mardi 16 février 2021
      • Réunion référentes du mardi 2 février 2021
      • Réunion Référents du 19 janvier 2021
      • Avant 2021
        • Réunion Référents du 24 novembre 2020
        • Réunion référentes 3 décembre 2019
        • Réunion référentes du 8 décembre 2020
  • Informations générales
    • Informations générales et légales
      • Conditions d’utilisation de la plateforme RDV-Solidarités
      • Mentions Légales
      • Politique de confidentialité
      • À propos de RDV-Solidarités
      • Outils de prise de rendez-vous
      • Liste des champs stockés dans la base de données
      • Point de situation de l'équipe au 23 avril 2021
      • Incidents
        • Incident du 17 décembre 2021
        • Incident du 1er octobre 2021
        • Incident du 29 septembre 2021
        • Incident de septembre 2021
        • Incident du 7 septembre 2021
        • Incident du 29 avril 2021
        • Incident du 17 mars 2021
    • Dernières nouveautés
      • Modifications de 2021
      • Modifications de 2020
Powered by GitBook
On this page
  • Démonstration
  • Signatures des requêtes
  • Format des données
  • Tests
  • Implémentation côté RDV-Solidarités
  • Emails et icalendar
  1. Documentation Technique

API de notifications

RDV-Solidarités peut notifier votre système d’information à l’aide de webhooks ou en envoyant des ics par email.

PreviousMotifsNextFormat des données

Last updated 3 years ago

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

  • pour

Du code d’exemple est aussi .

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, !

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.

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. .

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

Emails et icalendar

Présentation faite aux DSIs :

En plus des webhooks, RDV-Solidarités peut notifier votre SI en .

https://interconnexions.votre-departement.fr/rdv-solidarites
Outlook
Microsoft Dynamics
disponible en C# et en NodeJS
https://webhook.site
contactez-nous
Comment vérifier la signature ?
Format des données
https://github.com/betagouv/rdv-solidarites.fr/blob/master/app/jobs/webhook_job.rb#L11
https://github.com/betagouv/rdv-solidarites.fr/tree/master/app/blueprints
https://docs.google.com/file/d/1leeQ1B507eNgi2pWfjaOor8TAtkhv6ao/edit?usp=docslist_api&filetype=mspresentation
envoyant des emails aux agents