eSign.AIeSign.AI
开发者中心

Ottieni il link alla pagina di creazione del modello di file

POST /esignglobal/v1/templates/create

Descrizione dell'interfaccia

Ottiene il link alla pagina di creazione del modello di file.

Gli sviluppatori possono ottenere un link temporaneo alla pagina di creazione del modello di file tramite questa interfaccia docTemplateCreateUrl, e aprire tale link per consentire agli operatori di creare un modello di file sulla pagina basato su un file specifico.

Note importanti

  • fileKey è la KEY del file ottenuta tramite l'interfaccia di caricamento dei file, utilizzata per specificare il file su cui si basa la creazione del modello corrente.
  • docTemplateType Il valore predefinito è 0, indica il modello PDF; passando 2 indica il modello HTML, adatto a scenari in cui si aggiungono dinamicamente righe a una tabella e si compilano i contenuti.
  • Dopo il successo della chiamata all'interfaccia viene restituito docTemplateCreateUrl, tale link è temporaneo; si consiglia di utilizzarlo immediatamente dopo l'ottenimento, evitando cache di lunga durata.
  • Gli sviluppatori possono utilizzare redirectUrl per specificare la pagina di reindirizzamento al termine della creazione del modello.

Parametri della richiesta

Nome del parametro

Tipo

Obbligatorio

Descrizione

docTemplateName

string

true

Nome del modello di file, personalizzabile.

fileKey

string

true

KEY del file, ottenuta tramite l'interfaccia di caricamento file.

docTemplateType

int

false

Tipo di modello di file, il valore predefinito è 0

0: modello PDF.

2: modello HTML, adatto per scenari in cui si aggiungono dinamicamente righe alla tabella e si compilano i contenuti.

redirectUrl

string

false

Link di reindirizzamento dopo la creazione del modello, deve essere un URL valido.

Esempio di richiesta

{
  "docTemplateName": "Sales Contract Template",
  "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c",
  "docTemplateType": 0,
  "redirectUrl": "https://example.com/template/create/callback"
}

Parametri di risposta

Nome del parametro

Tipo

Descrizione

code

int

Codice di stato.

message

string

Informazioni di risposta.

data

object

Dati di risposta.

 

docTemplateId

string

ID del modello di file appena creato.

 

docTemplateCreateUrl

string

Link alla pagina di creazione del modello di file, valido per un periodo limitato.

Esempio di risposta

{
  "code": 0,
  "message": "success",
  "data": {
    "docTemplateId": "template_123456789",
    "docTemplateCreateUrl": "https://app.esignglobal.com/template/create?token=example"
  }
}