Centro de desarrolladores

Crear sobre

POST /esignglobal/v1/envelope/create

Descripción de la interfaz

Crea un sobre en estado de borrador.

Parámetros de solicitud

Nombre del parámetro

Tipo

¿Requerido?

Descripción

subject

string

true

Asunto del sobre, ejemplo: “Carta de Oferta”

remark

string

false

Notas del sobre, longitud máxima de 1000 caracteres

signerSettings

object

false

Operaciones permitidas para el firmante

 

allowTransfer

boolean

false

Indica si se permite que el firmante transfiera este sobre a otra persona para que lo firme, el valor predeterminado es falso

true-Permite que el firmante del sobre tenga el poder de transferir el sobre a otros;

false-No permite que el firmante del sobre tenga el poder de transferir el sobre a otros;

 

allowModifyName

boolean

false

Indica si se permite que el firmante modifique el nombre, solo es efectivo para la firma de la plantilla, el valor predeterminado es falso

true-Permite que el firmante modifique el nombre

false- No se permite que el firmante modifique el nombre

expireAfterSeconds

long

false

Tiempo de expiración del sobre: después de cuántos segundos expira el sobre

Rango de expiración: 86,400 segundos (1 día) ~ 7,776,000 segundos (90 días).

redirectUrl

string

false

Dirección de redireccionamiento al completar la firma (longitud 2048), debe ser una dirección http válida

callBackUrl

string

false

Dirección de callback (longitud 500), debe ser una dirección de protocolo https / http

Ejemplo de solicitud

  {
    "subject": "api subject fdsfasdfafs",
    "remark": "This is a remark",
    "expireAfterSeconds": 888640,
    "redirectUrl": "https://www.example.com"
}

Parámetros de respuesta

Nombre del parámetro

Tipo

Descripción

envelopeId

string

ID del sobre

envelopeStatus

int

Estado del sobre

0 - Creado (borrador)

1 - En proceso de firma

2 - Completado

3-Caducado

5-Revocado

Ejemplo de respuesta

{
    "code": "0",
    "data": {
        "envelopeId": "9fbe6c8190824227bde29136b0145c81",
        "envelopeStatus": 0
    },
    "message": "success"
}

 

Descripción de la interfaz
Parámetros de solicitud
Ejemplo de solicitud
Parámetros de respuesta
Ejemplo de respuesta