Vai al contenuto principale

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 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 Document — DELETE /api/v1/document/{id}/ — aggiunto parametro query opzionale email=1 per inviare notifiche email 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 etichetta.
  • Risorsa Signer — aggiunto campo uuid all'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_signer e strict_fields ora accettano true/"true"/1 (prima solo booleano True).
  • Risorsa Signer/Element — Il campo signer ora è nullable; gli elementi element_type: "admin" hanno firmatario predefinito 0.
  • 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_reason nella 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 — role non è 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.