eSign.AIeSign.AI
Centre de développement

Obtenir le lien vers la page de création de modèle de fichier

POST /esignglobal/v1/templates/create

Description de l'interface

Obtient le lien vers la page de création du modèle de fichier.

Les développeurs peuvent utiliser cette interface pour obtenir un lien vers la page de création du modèle de fichier, valable pour une durée limitée docTemplateCreateUrl , et ouvrir ce lien afin que les opérateurs puissent créer un modèle de fichier sur la page à partir d'un fichier spécifié.

Remarques

  • fileKey correspond à la clé de fichier obtenue via l'interface de téléchargement de fichiers, utilisée pour spécifier le fichier sur lequel repose la création du modèle actuel.
  • docTemplateType par défaut 0 , indique un modèle PDF ; transmettre 2 indique un modèle HTML, adapté aux scénarios où des lignes de tableau sont ajoutées dynamiquement et remplies de contenu.
  • Retourne après un appel réussi de l'interface docTemplateCreateUrl , ce lien est temporaire. Il est recommandé de l'utiliser immédiatement après son obtention et il n'est pas conseillé de le mettre en cache pendant une longue période.
  • Les développeurs peuvent utiliser redirectUrl pour spécifier la page de redirection après la fin de la création du modèle.

Paramètres de requête

Nom du paramètre

Type

Obligatoire

Description

docTemplateName

string

true

Nom du modèle de fichier, personnalisable.

fileKey

string

true

Clé du fichier, obtenue via l'interface d'upload de fichiers.

docTemplateType

int

false

Type de modèle de fichier, la valeur par défaut est 0

0 : modèle PDF.

2 : modèle HTML, adapté aux scénarios nécessitant l'ajout dynamique de lignes de tableau et le remplissage de contenu.

redirectUrl

string

false

Lien de redirection après la création du modèle, doit être une URL valide.

Exemple de requête

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

Paramètres de réponse

Nom du paramètre

Type

Description

code

int

Code d'état.

message

string

Informations de réponse.

data

object

Données de réponse.

 

docTemplateId

string

ID du nouveau modèle de fichier.

 

docTemplateCreateUrl

string

Lien vers la page de création du modèle de fichier, valable pour une durée limitée.

Exemple de réponse

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