[Etude API] Prise de rdv (RDV Solidarites)

[emilschn]

Notes d'Arnaud

Concept :

• permettre aux agents des partenaires de fixer les rdv visites sur Histologe
• accélérerait la prise de rdv
• faciliterait la récupération de l info date de visite

API SE RDV SERVICE PUBLIC :

• Lien du dépôt : https://github.com/betagouv/rdv-solidarites.fr
• Guide d'utilisation pour les agent·es et les Conseillers numériques France Service : doc.rdv-solidarites.fr
• Documentation de l'API : www.rdv-solidarites.fr/api-docs
• Documentation de l'API de notifications (webhooks) : docs/api/webhooks/api-notifications-webhooks.md
• Documentation architechture et sécurité : https://github.com/Scttpr/rdv-solidarites.fr/blob/chore/add-security.txt/docs/architecture-technique.md
• Information_source: Le swagger API n'est pas totalement à jour. Il y a quelques endpoints non référencés, mais le gros de l'existant y est

[emilschn]

Notes après première lecture

Possibilité d'avoir un accès demo

Structure

Chaque agent a un compte personnel. Les requêtes faites sur l'API sont authentifiées grace à des tokens d'accès associés à chaque agent. Conclusion : chaque agent (ou partenaire pour chaque agent) devra renseigner un token d'accès pour se connecter.

Le service est segmenté par organisation, qui peut avoir des admins, des secrétaires et des agents qui ont chacun des droits différents (et des accès aux données qu'on retrouve dans l'API). Un agent peut apparemment être dans une ou plusieurs organisations.

Fonctionnement

Organiser un RDV

1/ Récupération d'usager existant via GET avec adresse email sur /user

OU

Création d'usager via un POST sur /user Nom, prénom, date de naissance, email, téléphone, adresse, ...

2/ Lier un agent et un usager via un POST sur /referent_assignations

3/ Créer un token d'invitation pour l'usager à prendre RDV via un POST sur /users/{user_id}/rdv_invitation_token On doit ensuite faire parvenir ce token à l'usager

Récupérer des notifications

Possibilité de recevoir des notifications via Webhooks pour les mises à jour : https://github.com/betagouv/rdv-solidarites.fr/blob/production/docs/api/webhooks/api-notifications-webhooks.md

Liaison organisation - partenaires

J'imagine que ça aurait du sens de lier leur donnée Organisation et notre donnée Partenaire. Mais pour l'instant, je ne sais pas quoi en faire :)

Changement de processus des visites

Actuellement : les agents remplissent la modale avec une date prévue dans le futur.

Changement induit : si la connexion existe, il faudrait :

• pouvoir créer des visites sans date prévue,
• que l'agent envoie une notification à l'usager,
• qu'on stocke cette "demande envoyée",
• qu'ensuite on mette à jour la date après notification via Webhook
• éventuellement mettre à jour le statut avec les notifs liées au RDV

[hmeneuvrier]

on garde ça ? Il me semblait qu'on avait un peu laissé tomber