Signaturdatei hinzufügen

POST /esignglobal/v1/envelope/files/addSignFiles

Schnittstellenbeschreibung

Wenn der Umschlag noch nicht geöffnet wurde, können dem Umschlag zu unterzeichnende Dateien hinzugefügt werden. Für bereits geöffnete Umschläge ist das Hinzufügen von Unterzeichnungsdateien nicht möglich.

Anfrageparameter

Parametername			Typ	Pflichtfeld	Beschreibung
envelopeId			string	true	Umschlag-ID
signFiles			array	true	Sammlung der Informationen zu den Unterzeichnungsdateien; die Anzeigereihenfolge entspricht der Reihenfolge der Dateihinzufügung.
	fileKey		string	true	fileKey der Unterzeichnungsdatei, nur PDF-Format unterstützt
	documentFields		array	false	Liste der dateibezogenen Steuerelemente. Wird verwendet, um dateibezogene Steuerelemente ohne Zuordnung zu einem bestimmten Unterzeichner auf einer angegebenen Datei hinzuzufügen.
		fieldType	string	false	Steuerelementtyp. Geben Sie eMeterai an, um das indonesische Steuermarkensteuerelement darzustellen.
		pageNo	string	false	Seitennummer des Steuerelements. Das indonesische Steuermarkensteuerelement unterstützt nur die Angabe einer einzelnen Seite; es muss eine einzelne Seitennummer übergeben werden. Formate für zusammenhängende oder nicht zusammenhängende Mehrfachseiten wie „1-3“ oder „1,3“ werden nicht unterstützt.
		posX	float	false	X-Achsenversatz, wobei die linke untere Ecke der Seite als Koordinatenursprung dient. Der Koordinatenbereich entspricht dem anderer Steuerelementkoordinatenbereiche.
		posY	float	false	Y-Achsenversatz, wobei die linke untere Ecke der Seite als Koordinatenursprung dient. Der Koordinatenbereich entspricht dem anderer Steuerelementkoordinatenbereiche.

Anfragebeispiel

{   
  "envelopeId": "9fbe6c8190824227bde29136b0145c81",
  "signFiles": [
  {
    "fileKey": "4150a67c-d4f0-45e6-88e9-541ce6d0c73c"
  }
]
}

Antwortparameter

Parametername	Typ	Beschreibung
code	int	Geschäftscode, 0 bedeutet Erfolg, ungleich 0 bedeutet Fehler.
message	string	Geschäftsinformation [Hinweis] Bitte bewerten Sie den Fehler anhand des Codes. Verlassen Sie sich nicht auf die Übereinstimmung mit der Nachricht, da diese angepasst werden kann.
data	object	Geschäftsdaten

Antwortbeispiel

{
    "code": "0",
    "message": "success",
    "data": null
}