En modifiant un contact existant
Mettre à jour la fiche d'un contact — un nouveau mobile, une adresse — dans la requête qui crée son parcours.
curl -X POST "https://staging-api.docage.com/Transactions/CreateFullTransaction" \
-H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9…" \
-F 'Transaction={"Name":"Contrat avec Atelier Lumière","TransactionFiles":[{"FriendlyName":"Contrat","Name":"Contrat de prestation"}],"TransactionMembers":[{"FriendlyName":"Client","MemberRole":0,"SignMode":0}]}' \
-F 'Client={"Id":"00000000-0000-4000-8000-000000000201","Mobile":"+33600000009","City":"Villeurbanne"}' \
-F "Contrat=@contrat-atelier-lumiere.pdf;type=application/pdf" \
-F 'Client,Contrat={"Pages":"-1","Coordinates":"320,90,180,100"}'Un contact en JSON qui porte son Id met à jour ce contact, puis le désigne pour le participant. Seules les propriétés envoyées
changent : ici le mobile et la ville ; le nom, l'email et le reste de la fiche restent tels quels.
Les refus
Il faut avoir le droit de modifier le contact : sinon 400, « Impossible de mettre à jour le contact lié à Client », et rien n'est
créé.
Les pièges
- La fiche est modifiée aussitôt, avant le parcours : un parcours dont la création échoue ensuite laisse le contact modifié.
- Le participant prend les coordonnées de la fiche mise à jour : c'est le nouveau mobile qui reçoit le code par SMS.
- Pour désigner le contact sans rien changer à sa fiche, envoyez son seul identifiant : voir Avec un contact existant.