eSign.AIeSign.AI
Entwicklerzentrum

Link zur Dateivorlagen-Bearbeitungsseite abrufen

POST /esignglobal/v1/templates/edit

Schnittstellenbeschreibung

Entwickler können über diese Schnittstelle den Link zur Bearbeitung der angegebenen Dateivorlage abrufen docTemplateEditUrl und diesen Link öffnen, damit der Benutzer die vorhandene Dateivorlage auf der Seite bearbeiten kann.

Hinweise

  • docTemplateId ist die ID der Dateivorlage und muss eine gültige Vorlage sein, auf die das Konto des aktuellen Integrationsteilnehmers zugreifen darf.
  • Nach erfolgreichem Aufruf der Schnittstelle wird zurückgegeben docTemplateEditUrl . Dieser Link ist nur kurzzeitig gültig. Es wird empfohlen, ihn unmittelbar nach dem Abruf zu verwenden. Ein langfristiges Caching wird nicht empfohlen.
  • Entwickler können über redirectUrl die Weiterleitungsseite nach Abschluss der Bearbeitung der Vorlage festlegen.

Anfrageparameter

Parametername

Typ

Erforderlich

Beschreibung

docTemplateId

string

true

ID der Dateivorlage, muss eine gültige Vorlage im Konto des aktuellen Integrationsteilnehmers sein.

redirectUrl

string

false

Weiterleitungslink nach Abschluss der Vorlagenbearbeitung, muss eine gültige URL sein.

Anfragebeispiel

{
  "docTemplateId": "template_123456789",
  "redirectUrl": "https://example.com/template/edit/callback"
}

Antwortparameter

Parametername

Typ

Beschreibung

code

int

Statuscode.

message

string

Antwortinformation.

data

object

Antwortdaten.

data.docTemplateEditUrl

string

Link zur Dateivorlagen-Bearbeitungsseite, zeitlich begrenzt gültig.

Antwortbeispiel

{
  "code": 0,
  "message": "success",
  "data": {
    "docTemplateEditUrl": "https://app.esignglobal.com/template/edit?token=example"
  }
}