Journal des modifications de l'API REST
Modifications de l'API REST v1 (/api/v1/).
2026
2026-07-02
Ressource TemplatePDF — Nouveau point de terminaison : GET /api/v1/templatepdf/{id}/component-token/ — retourne un jeton de composant viewer pour intégrer le composant visualiseur PDF.
2026-07-01
Ressource Signer — Nouveau point de terminaison : GET /api/v1/signer/{id}/component-token/ — retourne un jeton de composant pour intégrer le composant de signature. Nécessite une clé API non héritée et le groupe doit être activé pour l’utilisation du composant.
2026-05-20
Ressource Document — Les liens de signature retournés dans la réponse API sont maintenant conservés sous forme de liens au format hérité pour compatibilité ascendante lors de la signature en lot/salle d’attente.
2026-04-28
Authentification — Un nouveau schéma de clé API est maintenant disponible. Les clés existantes continuent de fonctionner. Il est fortement recommandé aux développeurs de faire la mise à jour — voir developer.legalesign.com pour les détails.
2026-01-21
Ressource TemplatePDF — DELETE /api/v1/templatepdf/{id}/delete/ — suppression mise à jour pour suppression sécurisée. Retourne une erreur en cas d’échec (par ex. la politique de conservation nécessite une approbation secondaire).
2026-01-06–07
Ressource Document — Ajout du champ booléen append_history à l’envoi de document et à la réponse de détail. Lorsque true, la page d'historique de signature est ajoutée au PDF final (comporte le même comportement que append_pdf existant).
Obsolète : les champs sign_mouse, sign_type, sign_upload sur la ressource document sont obsolètes et seront supprimés dans une prochaine 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 vers le flux de signature.
2025-10-08
- Ressource Document — La réponse
GET /api/v1/document/{id}/inclut désormais un tableausigner_objectsen plus du tableausignersexistant. Chaque objet contient :firstname,lastname,email,tel,status,order,resource_uri,role,uuid. - Ressource Signer — Ajout du champ
roledans la réponse signataire ("signer","approver", ou"witness").
2025-09-26
- Ressource Document —
DELETE /api/v1/document/{id}/— ajout du paramètre facultatifemail=1pour envoyer des emails de notification lors de la suppression. - Ressource TemplatePDF — ajout du paramètre
hide_sender_fieldsau point de terminaison d’édition PDF. - Ressource Element/Field — les recherches
pdftextetsignertextacceptent désormais l’UUID en plus du nom du label. - Ressource Signer — ajout du champ
uuidà l’objet de réponse signataire.
2025-09-04
Ressource Document — Lorsqu’aucun message n’est fourni à l’envoi, le modèle de message par défaut du groupe est maintenant utilisé automatiquement.
2025-08-22
Ressource Document — Lors de l’envoi d’un document, le PDF source est maintenant copié du modèle vers l’enregistrement du 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 append_to obsolète. Ce paramètre n’avait aucun effet et a été retiré.
2024-08-21
- Ressource Utilisateur — Les utilisateurs créés via l’API se voient désormais assigner un mot de passe permanent (et non temporaire à réinitialiser).
- Ressource Document — Valeurs d’élément admin signataire gérées correctement pour l’index signataire 0.
2024-08-20
- Ressource Document — Les paramètres
convert_sender_to_signeretstrict_fieldsacceptent désormaistrue/"true"/1(auparavant uniquement booléenTrue). - Ressources Signer/Element — Le champ
signerest maintenant nullable ; les éléments avecelement_type: "admin"utilisent par défaut le signataire0. - Rôles — Les rôles API se synchronisent désormais avec la console après création de document.
- Messages d’erreur — Amélioration du message d’erreur quand l’utilisateur n’a pas de lien d’organisation.
2024-08-19
Ressource Groupe (Tab) — POST /api/v1/group/ — name est désormais le seul champ obligatoire. xframe_allow devient un paramètre optionnel.
2024-07-16
Ressource Document — Le paramètre cc accepte désormais la valeur "default" pour utiliser la liste de CC par défaut du groupe.
2024-06-14
Ressource Document — Ajout des champs pdf_password et pdf_password_type à la réponse détaillée du document.
2024-02-20
Ressource TemplatePDF — GET /api/v1/templatepdf/{id}/ (téléchargement PDF) — ajout du paramètre returnAsJson en requête pour retourner le PDF au format JSON encodé en base64 au lieu d’un téléchargement de fichier.
2024-02-09
Ressource TemplatePDF — Correction d’une 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 optionnel returnAsJson en requête. Lorsqu’il est défini, le corps de 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/ optimisé (requête de comptage plus rapide).
2023
2023-09-27
Ressource Document — GET /api/v1/document/ — ajout de deux nouveaux paramètres de filtre en requête :
created_gt— filtre les documents créés après une date/heure donnée (ISO 8601)modified_gt— filtre les documents modifiés après une date/heure donnée (ISO 8601)
Les URL de pagination next/previous incluent maintenant 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 désormais 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 Signer — Ajout du champ
rejection_reasondans la réponse signataire. - Nommage — Corrections de cohérence sur la dénomination des champs à travers l’API.
2023-03-02
Webhooks — Extension de la longueur maximale du champ callback_url de 200 à 500 caractères.
2023-01-17
Ressource Document — Ajout des champs tag2 et tag3 (en plus des tag/tag1 existants) à 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 Element/Field — Ajout du champ no_pdf: option pour marquer un champ afin qu’il ne soit pas rendu dans le PDF final.
2022-04-20
- Ressource Document —
rolen’est plus obligatoire dans le dictionnaire signataire lors de l’envoi d’un document utilisant un TemplatePDF. - Rapports d’erreur — Amélioration des messages de réponse d’erreur dans toute l’API.
2022-04-06
Ressource Element/Field — Ajout du type de validation regex (type validation 93) pour les valeurs de champ.
2022-02-24
Ressource Element/Field — Ajout du champ label_extra.
2022-02-22
Ressource TemplatePDF — Ajout de l’option force_download lors de la récupération du 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 champ honorifics supporté lors du POST document.
2021
2021-11-30
Ressource Document — Nouveau point de terminaison : GET /api/v1/document/{id}/auditlog/ — retourne le journal d’audit d’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 des champs lors de l’envoi de documents via l’API.
2021-10-27
Ressource Document — Nouveau point de terminaison : GET /api/v1/document/{id}/fields/ — retourne les données des champs d’un document.
2021-10-25
Ressource Document — Ajout du support bundle. 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.