Registro delle modifiche REST API
Modifiche alla REST API v1 (/api/v1/).
2026
2026-08-26
Risorsa TemplatePDF — Nuovo endpoint: GET /api/v1/templatepdf/{pdfId}/preview/ — restituisce un'anteprima PDF per il template specificato.
2026-08-14
Risorsa Element/Field — GET /api/v1/document/{id}/fields/ — aggiunto il parametro di 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 del 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 del componente per incorporare il componente di firma. Richiede una chiave API non legacy e il gruppo deve essere abilitato per l'uso del componente.
2026-05-20
Risorsa Document — I link di firma del firmatario restituiti nella risposta API ora vengono mantenuti come link in formato legacy per la compatibilità retroattiva quando si utilizza 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/ — cancellazione aggiornata per una cancellazione sicura. Restituisce un errore se fallisce (ad es. la politica di retention richiede una seconda approvazione).
2026-01-06–07
Risorsa Document — Aggiunto campo booleano append_history alla risposta di invio e dettaglio del documento. Quando è true, la pagina della cronologia della firma viene aggiunta al PDF completato (rispecchia il comportamento esistente di append_pdf).
Deprecato: i campi sign_mouse, sign_type, sign_upload sulla risorsa documento sono deprecati e saranno rimossi in una versione futura.
2025
2025-12-18–19
Risorsa Document — Aggiunto parametro skip per i firmatari durante l'invio di un documento. Impostando skip: true su una posizione firmatario, quel destinatario viene omesso dall'invio. Anche i testimoni successivi a un firmatario saltato sono saltati automaticamente.
2025-10-30
Risorsa Document — La creazione della politica di retention è stata spostata dall'invio API al flusso di firma.
2025-10-08
- Risorsa Document — la risposta di
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 di 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
pdftextesignertextora accettano UUID oltre al nome dell’etichetta. - Risorsa Signer — aggiunto campo
uuidall'oggetto firmatario nella risposta.
2025-09-04
Risorsa Document — Quando non viene fornito un messaggio all'invio, viene ora utilizzato automaticamente il template di messaggio predefinito del gruppo.
2025-08-22
Risorsa Document — Quando si invia un documento, il PDF di origine viene ora copiato dal template al record del 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 il 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 resettare).
- Risorsa Document — I valori elemento admin per i firmatari sono 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 può essere nullo; gli elementi conelement_type: "admin"hanno di default firmatario0. - Ruoli — I ruoli API ora si sincronizzano con la console dopo la creazione del documento.
- Messaggi di errore — Messaggio di errore migliorato quando l’utente non ha un 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 email CC predefinita del gruppo.
2024-06-14
Risorsa Document — Aggiunti campi pdf_password e pdf_password_type alla risposta di dettaglio documento.
2024-02-20
Risorsa TemplatePDF — GET /api/v1/templatepdf/{id}/ (download PDF) — aggiunto parametro di query returnAsJson per restituire il PDF come risposta JSON codificata base64 invece che come 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 di 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 di conteggio più veloce).
2023
2023-09-27
Risorsa Document — GET /api/v1/document/ — aggiunti due nuovi parametri di 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 ora includono correttamente tutti i parametri di filtro attivi.
2023-08-08
Risorsa Document — GET /api/v1/document/ — aggiunto parametro di 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 del promemoria.
2023-04-17
- Risorsa Signer — Aggiunto campo
rejection_reasonnella risposta firmatario. - Nomenclatura — Correzioni di coerenza nella denominazione 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 alla risposta documento.
2022
2022-11-14–15
Risorsa Document — Incrementato il 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 di richiesta message_template per specificare un template di messaggio all’invio.
2022-05-12
Risorsa Element/Field — Aggiunto campo no_pdf: opzione per contrassegnare un campo affinché non venga mostrato nel PDF finale.
2022-04-20
- Risorsa Document — Il campo
rolenon è più obbligatorio nel dizionario firmatario durante l'invio di un documento usando un TemplatePDF. - Report errori — Migliorate le risposte di errore nell’intera 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 sul recupero della bozza PDF.
2022-02-17
Risorsa Document — Aggiunto supporto per i reviewers all'invio di un documento.
2022-02-15
Risorsa Document — Aggiunto supporto per il campo honorifics nel 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 di GET /api/v1/document/ ora include un campo tag.
2021-10-30
Risorsa Document — La risposta di GET /api/v1/document/ ora include un campo location.
2021-10-28
Risorsa Document — Aggiunto supporto per la validazione dei campi durante l'invio di documenti via API.
2021-10-27
Risorsa Document — Nuovo endpoint: GET /api/v1/document/{id}/fields/ — restituisce i dati dei campi per un documento.
2021-10-25
Risorsa Document — Aggiunto supporto bundle. Aggiunto parametro convert_sender_to_signer durante l'invio di un documento.
2021-08-17
Risorsa TemplatePDF — Aggiunto campo archive_upon_send nella lista dei campi della risorsa Template PDF.