eSign.AIeSign.AI
Centro de desarrolladores

Obtener el enlace a la página de creación de plantillas de archivos

POST /esignglobal/v1/templates/create

Descripción de la interfaz

Obtiene el enlace a la página de creación de plantillas de archivos.

Los desarrolladores pueden obtener un enlace con validez temporal a la página de creación de plantillas de archivos docTemplateCreateUrl , y abrir dicho enlace para que el operador cree una plantilla de archivo en la página basada en un archivo específico.

Notas importantes

  • fileKey es la KEY del archivo obtenida mediante la interfaz de carga de archivos, utilizada para especificar el archivo sobre el cual se basará la creación de la plantilla actual.
  • docTemplateType El valor predeterminado es 0 , lo que indica una plantilla PDF; al pasar 2 , indica una plantilla HTML, adecuada para escenarios donde se agregan filas de tabla dinámicamente y se rellenan los datos.
  • Tras una llamada exitosa a la interfaz, se devuelve docTemplateCreateUrl . Este enlace tiene validez temporal; se recomienda utilizarlo inmediatamente después de obtenerlo y no se sugiere almacenarlo en caché durante mucho tiempo.
  • Los desarrolladores pueden redirectUrl especificar la página de redirección una vez completada la creación de la plantilla.

Parámetros de solicitud

Nombre del parámetro

Tipo

Obligatorio

Descripción

docTemplateName

string

true

Nombre de la plantilla del archivo, personalizable.

fileKey

string

true

KEY del archivo, obtenido a través de la interfaz de carga de archivos.

docTemplateType

int

false

Tipo de plantilla del archivo, el valor predeterminado es 0

0: Plantilla PDF.

2: Plantilla HTML, adecuada para escenarios en los que se agregan filas de tabla de forma dinámica y se rellenan con contenido.

redirectUrl

string

false

Enlace de redireccionamiento tras completar la creación de la plantilla, debe ser una URL válida.

Ejemplo de solicitud

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

Parámetros de respuesta

Nombre del parámetro

Tipo

Descripción

code

int

Código de estado.

message

string

Información de respuesta.

data

object

Datos de respuesta.

 

docTemplateId

string

ID de la nueva plantilla de archivo.

 

docTemplateCreateUrl

string

Enlace a la página de creación de plantillas de archivo, con validez temporal.

Ejemplo de respuesta

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