Migration 1.2 vers la 2.0

Guide de migration vers la nouvelle version 2.0

La version 2.0 de la DevBox-santé MSS apporte le support du nouveau référentiel v2 conforme au ségur vague 2

Quelques changements ont été apportés.

Exécution

Vous pouvez essayer l’API V2 avec une collection postman disponible ici :

Run In postman

ou le swagger :

Swagger

Authentification

2 modes d’authentification sont disponibles:

  • Pro Santé Connect
  • Certificat p12 (cas d’une bal applicative)

La connexion par carte cps est supprimée et la connexion par login/mdp/otp est à priori supprimée (à voir selon l’opérateur)

Modèle

  • Modification du type des identifiants (id, folderId, messageId) integer => string

Folder_dans_swagger.png

FolderId dans les routes

  • Modification des Flags:
    • REPLIED => ANSWERED
    • UNREAD => SEEN
    • ATTACHMENT, LOW_PRIORITY, NONE, PRIORITY, SENT_BY_ME, URGENT => Deprecated
    • Nouveaux flags: RECENT, ANSWERED, SEEN
    • Liste complète en V2: ANSWERED, DELETED, DRAFT, FLAGGED, FORWARDED, SEEN, RECENT
  • Modification d’un message (MessageStatus):
    • DELETE => DELETED
    • DELETE, SPAM, TRASH, UNSPAM => Deprecated
    • DELETED, READ, FLAGGED, UNFLAGGED, UNREAD, UNDELETED
  • MessageQuery
    • isSent => sent

Rest API

Les APIs v2 sont disponible sur l’url /mssante/v2/xxxx, elles ont les mêmes signatures que la V1 à quelques exceptions près:

Endpoints supprimés

  • Authentification : GET /authentication/cps, POST /authentication/otp, GET /authentication/otp/{otp}
  • POST /messages/attachment Ajout de pièce jointe => Faire un save du message brouillon avec la PJ
  • DELETE /messages/{id}/attachment/{part} Suppression d’une pièce jointe => Faire un save du message brouillon sans la PJ

Nouveaux endpoints

  • Vider la corbeille: DELETE /folders/trash/clean (=> suppression des messages ayant le flag DELETED)
  • POST /folders/{parentId}/create/type/{type}: Lors de la création d’un dossier ce dernier est “typé” comme contenant des messages ou des dossiers. Si le endpoint ne permet pas de préciser le type alors le dossier est par défaut contenant des messages.
  • POST /folders/{id}/rename
  • GET /messages/{folderId}/ByPage: recherche paginée