Avec un nouveau contact
Faire signer votre document à une personne qui n'est pas encore un contact — le contact est créé avec le 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":1}]}' \
-F 'Client={"FirstName":"Camille","LastName":"Martin","Email":"camille.martin@example.com","Mobile":"+33600000001","Address1":"12 rue des Lilas","ZipCode":"69003","City":"Lyon","Country":"FR"}' \
-F "Contrat=@contrat-atelier-lumiere.pdf;type=application/pdf" \
-F 'Client,Contrat={"Pages":"-1","Coordinates":"320,90,180,100"}'Sous l'identifiant convivial du participant, un contact en JSON : ses propriétés sont celles d'un contact (FirstName,
LastName, Email, Mobile, Phone, Address1, Address2, ZipCode, City, Country, Job…). Le contact est enregistré avec
le parcours — une création qui échoue n'en laisse aucun —, et le participant prend ses coordonnées.
Ce qui est vérifié, et quand
Rien n'est vérifié à la création du contact. L'envoi exige de chaque participant un email valide, un prénom et un nom, et un mobile pour un code par SMS ; un manque fait refuser l'envoi (« Client : n'a pas un prénom valide »…) et laisse le parcours en brouillon, avec le contact créé.
Les pièges
- Aucun contrôle de doublon n'empêche cette création : cherchez d'abord la personne par son email, et désignez son contact s'il existe.
- Un JSON qui porte un
Idne crée rien : il met à jour ce contact — voir En modifiant un contact existant. Countryest un code de pays ISO à deux lettres (FR) ; un libellé (« FRANCE ») est gardé tel quel, sans être reconnu.- Écrivez un numéro au format international E.164 (
+33600000001).