Vai al contenuto principale

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/FieldGET /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 TemplatePDFDELETE /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 array signer_objects insieme all'esistente array signers. Ogni oggetto contiene: firstname, lastname, email, tel, status, order, resource_uri, role, uuid.
  • Risorsa Signer — aggiunto campo role alla risposta del firmatario ("signer", "approver", o "witness").

2025-09-26

  • Risorsa DocumentDELETE /api/v1/document/{id}/ — aggiunto parametro di query opzionale email=1 per inviare email di notifica alla cancellazione.
  • Risorsa TemplatePDF — aggiunto parametro hide_sender_fields all’endpoint di modifica PDF.
  • Risorsa Element/Field — le ricerche pdftext e signertext ora accettano UUID oltre al nome dell’etichetta.
  • Risorsa Signer — aggiunto campo uuid all'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_signer e strict_fields ora accettano true/"true"/1 (prima solo booleano True).
  • Risorsa Signer/Element — Il campo signer ora può essere nullo; gli elementi con element_type: "admin" hanno di default firmatario 0.
  • 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 TemplatePDFGET /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_uridocument_uri.

2024-01-26

Risorsa TemplatePDFPOST /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 DocumentGET /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 DocumentGET /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_reason nella 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 role non è 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.