Registro delle modifiche REST API
Modifiche alla REST API v1 (/api/v1/).
2026
2026-07-02
Risorsa TemplatePDF — Nuovo endpoint: GET /api/v1/templatepdf/{id}/component-token/ — restituisce un token componente viewer per incorporare il componente visualizzatore PDF.
2026-07-01
Risorsa Signer — Nuovo endpoint: GET /api/v1/signer/{id}/component-token/ — restituisce un token componente per incorporare il componente di firma. Richiede una chiave API non legacy e il gruppo deve essere abilitato per l’uso di componenti.
2026-05-20
Risorsa Document — I link di firma dei firmatari restituiti nella risposta API vengono ora preservati come link in formato legacy per la compatibilità retroattiva nell’uso di firme in batch/lobby.
2026-04-28
Autenticazione — Ora è disponibile un nuovo schema di chiave API. Le chiavi esistenti continuano a funzionare. Si consiglia vivamente agli sviluppatori di aggiornare — vedi developer.legalesign.com per dettagli.
2026-01-21
Risorsa TemplatePDF — DELETE /api/v1/templatepdf/{id}/delete/ — cancellazione aggiornata per una cancellazione sicura. Restituisce un errore se fallisce (ad esempio la policy di retention richiede approvazione secondaria).
2026-01-06–07
Risorsa Document — Aggiunto campo booleano append_history all’invio del documento e alla risposta dettagli. Se true, alla pagina PDF completata viene aggiunta la cronologia di firma (rispecchia il comportamento esistente di append_pdf).
Deprecato: i campi sign_mouse, sign_type, sign_upload nella risorsa documento sono deprecati e verranno rimossi in una futura versione.
2025
2025-12-18–19
Risorsa Document — Aggiunto parametro skip per i firmatari quando si invia un documento. Impostare skip: true su una posizione firmatario esclude quel destinatario dall’invio. I testimoni che seguono un firmatario saltato sono anch’essi automaticamente saltati.
2025-10-30
Risorsa Document — La creazione della policy di retention è stata spostata dall’invio API al flusso di firma.
2025-10-08
- Risorsa Document — La risposta
GET /api/v1/document/{id}/ora include un arraysigner_objectsaccanto all’esistente arraysigners. Ogni oggetto contiene:firstname,lastname,email,tel,status,order,resource_uri,role,uuid. - Risorsa Signer — Aggiunto il campo
rolealla risposta firmatario ("signer","approver", o"witness").
2025-09-26
- Risorsa Document —
DELETE /api/v1/document/{id}/— aggiunto parametro query opzionaleemail=1per inviare email di notifica alla cancellazione. - Risorsa TemplatePDF — Aggiunto parametro
hide_sender_fieldsall’endpoint di modifica PDF. - Risorsa Element/Field — Le ricerche
pdftextesignertextaccettano ora UUID oltre al nome etichetta. - Risorsa Signer — Aggiunto campo
uuidall’oggetto firmatario della risposta.
2025-09-04
Risorsa Document — Se non viene fornito alcun messaggio all’invio, viene ora utilizzato automaticamente il modello di messaggio predefinito del gruppo.
2025-08-22
Risorsa Document — Quando si invia un documento, il PDF sorgente viene ora copiato dal modello al record documento.
2025-06-10
Risorsa TemplatePDF — Nuovo endpoint: POST /api/v1/templatepdf/{id}/archive/ — archivia un template PDF.
2024
2024-10-17
Risorsa Document — Rimosso parametro firmatario deprecato append_to. Questo parametro non aveva effetto ed è stato rimosso.
2024-08-21
- Risorsa User — Gli utenti creati tramite API ora ricevono una password permanente (non temporanea da reimpostare).
- Risorsa Document — I valori di elemento admin per i firmatari sono gestiti correttamente per l’indice firmatario 0.
2024-08-20
- Risorsa Document — I parametri
convert_sender_to_signerestrict_fieldsaccettano oratrue/"true"/1(precedentemente solo booleanoTrue). - Risorsa Signer/Element — Il campo
signerè ora nullo; gli elementi conelement_type: "admin"di default assegnano il firmatario0. - Ruoli — I ruoli API ora si sincronizzano con la console dopo la creazione del documento.
- Messaggi di errore — Migliorato errore quando un utente non ha collegamento all’organizzazione.
2024-08-19
Risorsa Group (Tab) — POST /api/v1/group/ — name è ora l’unico campo obbligatorio. xframe_allow è ora un parametro opzionale.
2024-07-16
Risorsa Document — Il parametro cc ora accetta il valore "default" per usare la lista CC email predefinita del gruppo.
2024-06-14
Risorsa Document — Aggiunti i campi pdf_password e pdf_password_type alla risposta dettagli documento.
2024-02-20
Risorsa TemplatePDF — GET /api/v1/templatepdf/{id}/ (download PDF) — aggiunto parametro query returnAsJson per restituire il PDF come risposta JSON codificata base64 anziché come file da scaricare.
2024-02-09
Risorsa TemplatePDF — Corretto refuso nella risposta returnAsJson: documet_uri → document_uri.
2024-01-26
Risorsa TemplatePDF — POST /api/v1/templatepdf/ — aggiunto parametro query opzionale returnAsJson. Se impostato, il corpo della risposta include { resource: { uid, status_uri, document_uri } } invece di un vuoto 201.
2024-01-21
Risorsa Document — Miglioramento delle prestazioni: GET /api/v1/document/ ottimizzato (query conteggio più veloce).
2023
2023-09-27
Risorsa Document — GET /api/v1/document/ — aggiunti due nuovi parametri filtro query:
created_gt— filtra documenti creati dopo una data/ora specificata (ISO 8601)modified_gt— filtra documenti modificati dopo una data/ora specificata (ISO 8601)
Gli URL di paginazione next/previous includono correttamente tutti i parametri filtro attivi.
2023-08-08
Risorsa Document — GET /api/v1/document/ — aggiunto parametro filtro sentUserId.
2023-07-07
Risorsa User — Gli utenti admin possono ora creare sotto-utenti via API.
2023-05-31
Risorsa Document — I testimoni non sono più inclusi nella lista destinatari predefinita per i promemoria.
2023-04-17
- Risorsa Signer — Aggiunto campo
rejection_reasonnella risposta firmatario. - Nomenclatura — Correzioni di coerenza nei nomi dei campi nell’API.
2023-03-02
Webhooks — Lunghezza massima del campo callback_url estesa da 200 a 500 caratteri.
2023-01-17
Risorsa Document — Aggiunti campi tag2 e tag3 (in aggiunta ai campi esistenti tag/tag1) per invio e risposta documento.
2022
2022-11-14–15
Risorsa Document — Aumentato numero massimo di campi consentiti per documento.
2022-11-02–03
Webhooks — Aggiunti nuovi tipi di eventi webhook. Aggiornati gli elementi usercallback.
2022-09-09
Risorsa Document — Aggiunto parametro richiesta message_template per specificare un modello messaggio durante l’invio.
2022-05-12
Risorsa Element/Field — Aggiunto campo no_pdf: opzione per marcare un campo in modo che non venga renderizzato sul PDF finale.
2022-04-20
- Risorsa Document —
rolenon è più richiesto nel dizionario firmatario quando si invia un documento usando un TemplatePDF. - Error reporting — Migliorate le risposte di errore in tutta l’API.
2022-04-06
Risorsa Element/Field — Aggiunto tipo di validazione regex (tipo validazione 93) per valori di campo.
2022-02-24
Risorsa Element/Field — Aggiunto campo label_extra.
2022-02-22
Risorsa TemplatePDF — Aggiunta opzione force_download per il recupero della bozza PDF.
2022-02-17
Risorsa Document — Aggiunto supporto ai reviewers durante l’invio di un documento.
2022-02-15
Risorsa Document — Aggiunto supporto al campo honorifics in POST documento.
2021
2021-11-30
Risorsa Document — Nuovo endpoint: GET /api/v1/document/{id}/auditlog/ — restituisce il registro audit di un documento.
2021-10-31
Risorsa Document — La risposta GET /api/v1/document/ ora include il campo tag.
2021-10-30
Risorsa Document — La risposta GET /api/v1/document/ ora include il campo location.
2021-10-28
Risorsa Document — Aggiunto supporto alla validazione dei campi quando si inviano documenti via API.
2021-10-27
Risorsa Document — Nuovo endpoint: GET /api/v1/document/{id}/fields/ — restituisce i dati dei campi di un documento.
2021-10-25
Risorsa Document — Aggiunto supporto a bundle. Aggiunto parametro convert_sender_to_signer durante l’invio di un documento.
2021-08-17
Risorsa TemplatePDF — Aggiunto campo archive_upon_send alla lista campi risorsa template PDF.