Registro delle modifiche REST API
Modifiche all'API REST v1 (/api/v1/).
2027
2027-10-27
Risorsa TemplatePDF — POST /api/v1/templatepdf/{pdfId}/preview/ sostituisce GET per la generazione di anteprime PDF con i campi del mittente compilati. GET rimane supportato.
2026
2026-08-26
Risorsa TemplatePDF — Nuovo endpoint: GET /api/v1/templatepdf/{pdfId}/preview/ — restituisce un'anteprima PDF per il modello specificato.
2026-08-14
Risorsa Element/Field — GET /api/v1/document/{id}/fields/ — aggiunto parametro filtro query element_type. Vedi Get Document Fields.
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 che il gruppo sia abilitato all'uso del componente.
2026-05-20
Risorsa Document — I link di firma per il firmatario restituiti nella risposta API vengono ora preservati come link in formato legacy per la retrocompatibilità quando si usa la firma batch/lobby.
2026-04-28
Autenticazione — È ora disponibile un nuovo schema di chiave API. Le chiavi esistenti continuano a funzionare. Si raccomanda vivamente agli sviluppatori di aggiornare — vedi developer.legalesign.com per i dettagli.
2026-01-21
Risorsa TemplatePDF — DELETE /api/v1/templatepdf/{id}/delete/ — aggiornamento della cancellazione per una cancellazione sicura. Restituisce un errore se fallisce (es. la policy di retention richiede approvazione secondaria).
2026-01-06–07
Risorsa Document — Aggiunto campo booleano append_history alla risposta di invio e dettaglio documento. Se true, la pagina della cronologia di firma viene aggiunta al PDF completato (rispecchia il comportamento esistente di append_pdf).
Deprecate: i campi sign_mouse, sign_type, sign_upload sulla risorsa documento sono deprecati e saranno rimossi in una prossima versione.
2025
2025-12-18–19
Risorsa Document — Aggiunto parametro skip per i firmatari durante l'invio di un documento. Impostare skip: true su una posizione firmatario esclude quel destinatario dall'invio. I testimoni dopo 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_objectsinsieme all'esistente arraysigners. Ogni oggetto contiene:firstname,lastname,email,tel,status,order,resource_uri,role,uuid. - Risorsa Signer — aggiunto campo
rolealla risposta del firmatario ("signer","approver", o"witness").
2025-09-26
- Risorsa Document —
DELETE /api/v1/document/{id}/— aggiunto parametro query opzionaleemail=1per inviare notifiche email alla cancellazione. - Risorsa TemplatePDF — aggiunto parametro
hide_sender_fieldsall'endpoint di modifica PDF. - Risorsa Element/Field — le ricerche
pdftextesignertextora accettano UUID oltre al nome etichetta. - Risorsa Signer — aggiunto campo
uuidall'oggetto risposta firmatario.
2025-09-04
Risorsa Document — Quando 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 PDF modello.
2024
2024-10-17
Risorsa Document — Rimosso il parametro firmatario append_to deprecato. Questo parametro non aveva effetto ed è stato rimosso.
2024-08-21
- Risorsa User — Gli utenti creati via API ricevono ora una password permanente (non temporanea che richiede reset).
- Risorsa Document — Valori di elemento amministrativo per firmatari gestiti correttamente per l'indice firmatario 0.
2024-08-20
- Risorsa Document — I parametri
convert_sender_to_signerestrict_fieldsora accettanotrue/"true"/1(prima solo booleanoTrue). - Risorsa Signer/Element — Il campo
signerora è nullable; gli elementielement_type: "admin"hanno firmatario predefinito0. - 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 un link all'organizzazione.
2024-08-19
Risorsa Group (Tab) — POST /api/v1/group/ — name è ora l'unico campo obbligatorio. xframe_allow è parametro opzionale.
2024-07-16
Risorsa Document — Il parametro cc ora accetta il valore "default" per usare la lista email CC predefinita del gruppo.
2024-06-14
Risorsa Document — Aggiunti campi pdf_password e pdf_password_type alla risposta dettaglio 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é un download file.
2024-02-09
Risorsa TemplatePDF — Corretto errore di battitura 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 prestazioni: GET /api/v1/document/ aggiornato (query conteggio più veloce).
2023
2023-09-27
Risorsa Document — GET /api/v1/document/ — aggiunti due nuovi parametri filtro query:
created_gt— filtra i documenti creati dopo una data/ora specifica (ISO 8601)modified_gt— filtra i documenti modificati dopo una data/ora specifica (ISO 8601)
Gli URL di paginazione next/previous ora 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 tramite API.
2023-05-31
Risorsa Document — I testimoni non sono più inclusi nella lista predefinita dei destinatari promemoria.
2023-04-17
- Risorsa Signer — Aggiunto campo
rejection_reasonnella risposta firmatario. - Nomenclatura — Correzioni di coerenza sui nomi dei campi nell’API.
2023-03-02
Webhooks — Estesa la lunghezza massima del campo callback_url da 200 a 500 caratteri.
2023-01-17
Risorsa Document — Aggiunti campi tag2 e tag3 (oltre ai già esistenti tag/tag1) all'invio e risposta documento.
2022
2022-11-14–15
Risorsa Document — Aumentato il numero massimo di campi consentiti per documento.
2022-11-02–03
Webhooks — Aggiunti nuovi tipi di evento webhook. Aggiornati gli elementi usercallback.
2022-09-09
Risorsa Document — Aggiunto parametro richiesta message_template per specificare un modello messaggio all'invio.
2022-05-12
Risorsa Element/Field — Aggiunto campo no_pdf: opzione per indicare che un campo non venga renderizzato nel PDF finale.
2022-04-20
- Risorsa Document —
rolenon è più richiesto nel dizionario firmatari per inviare un documento usando un TemplatePDF. - Gestione errori — Migliorati i messaggi di errore in tutta l’API.
2022-04-06
Risorsa Element/Field — Aggiunto tipo di validazione regex (tipo validazione 93) per i valori 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 all'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 di audit di un documento.
2021-10-31
Risorsa Document — La risposta GET /api/v1/document/ ora include un campo tag.
2021-10-30
Risorsa Document — La risposta GET /api/v1/document/ ora include un campo location.
2021-10-28
Risorsa Document — Aggiunto supporto alla validazione dei campi quando si inviano documenti tramite 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 all’invio documento.
2021-08-17
Risorsa TemplatePDF — Aggiunto campo archive_upon_send alla lista dei campi della risorsa template PDF.