Journal des modifications de l'API REST
Modifications de l'API REST v1 (/api/v1/).
2026
2026-08-26
Ressource TemplatePDF — Nouveau point de terminaison : GET /api/v1/templatepdf/{pdfId}/preview/ — renvoie un aperçu PDF pour le modèle spécifié.
2026-08-14
Ressource Élément/Champ — GET /api/v1/document/{id}/fields/ — ajout du paramètre de filtre de requête element_type. Voir Get Document Fields.
2026-07-02
Ressource TemplatePDF — Nouveau point de terminaison : GET /api/v1/templatepdf/{id}/component-token/ — renvoie un jeton de composant viewer pour intégrer le composant de visualisation PDF.
2026-07-01
Ressource Signataire — Nouveau point de terminaison : GET /api/v1/signer/{id}/component-token/ — renvoie un jeton de composant pour intégrer le composant de signature. Nécessite une clé API non héritée et que le groupe soit activé pour l'utilisation du composant.
2026-05-20
Ressource Document — Les liens de signature des signataires retournés dans la réponse API sont désormais conservés sous forme de liens au format hérité pour la compatibilité ascendante lors de la signature en lot/salle d'attente.
2026-04-28
Authentification — Un nouveau schéma de clé API est désormais disponible. Les clés existantes continuent de fonctionner. Il est fortement recommandé aux développeurs de mettre à jour — voir developer.legalesign.com pour plus de détails.
2026-01-21
Ressource TemplatePDF — DELETE /api/v1/templatepdf/{id}/delete/ — suppression mise à jour pour une suppression sécurisée. Renvoie une erreur en cas d’échec (par exemple, la politique de conservation nécessite une approbation secondaire).
2026-01-06–07
Ressource Document — Ajout du champ booléen append_history à la réponse d'envoi et de détail du document. Quand true, la page d'historique de signature est ajoutée au PDF complété (comporte comme le comportement existant append_pdf).
Déprécié : Les champs sign_mouse, sign_type, sign_upload sur la ressource document sont dépréciés et seront supprimés dans une future version.
2025
2025-12-18–19
Ressource Document — Ajout du paramètre skip pour les signataires lors de l’envoi d’un document. Définir skip: true sur une position de signataire omet ce destinataire de l’envoi. Les témoins suivant un signataire ignoré sont également automatiquement ignorés.
2025-10-30
Ressource Document — La création de la politique de conservation a été déplacée de l'envoi API au flux de signature.
2025-10-08
- Ressource Document — la réponse
GET /api/v1/document/{id}/inclut désormais un tableausigner_objectsen plus du tableau existantsigners. Chaque objet contient :firstname,lastname,email,tel,status,order,resource_uri,role,uuid. - Ressource Signataire — champ
roleajouté à la réponse signataire ("signer","approver", ou"witness").
2025-09-26
- Ressource Document —
DELETE /api/v1/document/{id}/— ajout du paramètre de requête optionnelemail=1pour envoyer des emails de notification lors de la suppression. - Ressource TemplatePDF — paramètre
hide_sender_fieldsajouté au point d’édition PDF. - Ressource Élément/Champ — recherches
pdftextetsignertextacceptent désormais un UUID en plus du nom d’étiquette. - Ressource Signataire — champ
uuidajouté à l’objet réponse signataire.
2025-09-04
Ressource Document — Lorsqu’aucun message n’est fourni lors de l’envoi, le modèle de message par défaut du groupe est automatiquement utilisé.
2025-08-22
Ressource Document — Lors de l’envoi d’un document, le PDF source est désormais copié du modèle vers l’enregistrement document.
2025-06-10
Ressource TemplatePDF — Nouveau point de terminaison : POST /api/v1/templatepdf/{id}/archive/ — archive un template PDF.
2024
2024-10-17
Ressource Document — Suppression du paramètre signataire déprécié append_to. Ce paramètre n’avait aucun effet et a été supprimé.
2024-08-21
- Ressource Utilisateur — Les utilisateurs créés par l’API se voient désormais attribuer un mot de passe permanent (et non temporaire exigeant une réinitialisation).
- Ressource Document — Les valeurs d’élément admin du signataire sont correctement gérées pour l’indice de signataire 0.
2024-08-20
- Ressource Document — Les paramètres
convert_sender_to_signeretstrict_fieldsacceptent maintenanttrue/"true"/1(auparavant seulement le booléenTrue). - Ressource Signataire/Élément — le champ
signerest désormais nullable ; les élémentselement_type: "admin"par défaut au signataire0. - Rôles — Les rôles API se synchronisent désormais avec la console après création du document.
- Messages d’erreur — Amélioration de l’erreur lorsque l’utilisateur n’a pas de lien organisationnel.
2024-08-19
Ressource Groupe (Onglet) — POST /api/v1/group/ — name est désormais le seul champ obligatoire. xframe_allow est désormais un paramètre optionnel.
2024-07-16
Ressource Document — Le paramètre cc accepte maintenant la valeur "default" pour utiliser la liste CC par défaut du groupe.
2024-06-14
Ressource Document — Ajout des champs pdf_password et pdf_password_type à la réponse de détail document.
2024-02-20
Ressource TemplatePDF — GET /api/v1/templatepdf/{id}/ (téléchargement PDF) — ajout du paramètre de requête returnAsJson pour retourner le PDF sous forme d’une réponse JSON encodée base64 au lieu d’un téléchargement de fichier.
2024-02-09
Ressource TemplatePDF — Correction de faute de frappe dans la réponse returnAsJson : documet_uri → document_uri.
2024-01-26
Ressource TemplatePDF — POST /api/v1/templatepdf/ — ajout du paramètre de requête optionnel returnAsJson. Lorsqu’il est défini, le corps de la réponse inclut { resource: { uid, status_uri, document_uri } } au lieu d’un 201 vide.
2024-01-21
Ressource Document — Amélioration des performances : GET /api/v1/document/ amélioré (requête de comptage plus rapide).
2023
2023-09-27
Ressource Document — GET /api/v1/document/ — ajout de deux nouveaux paramètres de filtre de requête :
created_gt— filtre les documents créés après une certaine date/heure (ISO 8601)modified_gt— filtre les documents modifiés après une certaine date/heure (ISO 8601)
Les URLs de pagination next/previous incluent désormais correctement tous les paramètres de filtre actifs.
2023-08-08
Ressource Document — GET /api/v1/document/ — ajout du paramètre de filtre sentUserId.
2023-07-07
Ressource Utilisateur — Les administrateurs peuvent maintenant créer des sous-utilisateurs via l’API.
2023-05-31
Ressource Document — Les témoins ne sont plus inclus dans la liste par défaut des destinataires des rappels.
2023-04-17
- Ressource Signataire — ajout du champ
rejection_reasonà la réponse signataire. - Nommage — corrections de cohérence dans la dénomination des champs à travers l’API.
2023-03-02
Webhooks — la longueur maximale du champ callback_url a été étendue de 200 à 500 caractères.
2023-01-17
Ressource Document — ajout des champs tag2 et tag3 (en plus des champs existants tag/tag1) à l'envoi et à la réponse document.
2022
2022-11-14–15
Ressource Document — Augmentation du nombre maximal de champs autorisés par document.
2022-11-02–03
Webhooks — Ajout de nouveaux types d’événements webhook. Mise à jour des éléments usercallback.
2022-09-09
Ressource Document — Ajout du paramètre de requête message_template pour spécifier un modèle de message lors de l’envoi.
2022-05-12
Ressource Élément/Champ — Ajout du champ no_pdf : option pour marquer un champ afin qu’il ne s’affiche pas sur le PDF final.
2022-04-20
- Ressource Document —
rolen’est plus obligatoire dans le dictionnaire signataire lors de l’envoi d’un document avec TemplatePDF. - Rapport d’erreurs — amélioration des messages d’erreur à travers l’API.
2022-04-06
Ressource Élément/Champ — Ajout du type de validation regex (type de validation 93) pour les valeurs de champ.
2022-02-24
Ressource Élément/Champ — Ajout du champ label_extra.
2022-02-22
Ressource TemplatePDF — Ajout de l’option force_download lors de la récupération d’un brouillon PDF.
2022-02-17
Ressource Document — Ajout du support des reviewers lors de l’envoi d’un document.
2022-02-15
Ressource Document — Ajout du support du champ honorifics sur le POST document.
2021
2021-11-30
Ressource Document — Nouveau point de terminaison : GET /api/v1/document/{id}/auditlog/ — renvoie le journal d’audit pour un document.
2021-10-31
Ressource Document — La réponse GET /api/v1/document/ inclut désormais un champ tag.
2021-10-30
Ressource Document — La réponse GET /api/v1/document/ inclut désormais un champ location.
2021-10-28
Ressource Document — Ajout du support de validation de champ lors de l’envoi de documents via API.
2021-10-27
Ressource Document — Nouveau point de terminaison : GET /api/v1/document/{id}/fields/ — renvoie les données de champ pour un document.
2021-10-25
Ressource Document — Ajout du support des bundles. Ajout du paramètre convert_sender_to_signer lors de l’envoi d’un document.
2021-08-17
Ressource TemplatePDF — Ajout du champ archive_upon_send à la liste des champs de la ressource template PDF.