eSign.AIeSign.AI
Sentro ng developer

Magdagdag ng file para sa pagpirma

POST /esignglobal/v1/envelope/files/addSignFiles

Deskripsyon ng Interface

Kapag ang envelope ay hindi pa binubuksan, suportado ang pagdaragdag ng mga file na handang i-sign sa envelope. Ang mga envelope na nagsimula nang bukas ay hindi sumusuporta sa pagdaragdag ng mga file para sa pag-sign.

Mga Parameter ng Hiling

Pangalan ng Parameter

Uri

Kailangan

Paliwanag

envelopeId

string

true

ID ng Envelope

signFiles

array

true

Koleksyon ng impormasyon ng mga file para sa pag-sign; ang ipinapakita na order ay base sa order ng pagdaragdag ng file.

 

fileKey

string

true

fileKey ng file para sa pag-sign, suportado lamang ang format ng PDF

 documentFieldsarrayfalseListahan ng mga control sa antas ng file. Ginagamit upang magdagdag ng mga control sa antas ng file na hindi nakatali sa tagapagsign sa isang tinukoy na file.
  

fieldType

string

false

Uri ng control. Ipadala ang eMeterai upang kumatawan sa control para sa stamp duty ng Indonesia.

  

pageNo

string

false

Page number kung saan matatagpuan ang control. Ang control para sa stamp duty ng Indonesia ay suportado lamang ang pagtukoy ng isang pahina; kailangang ipadala ang isang page number lamang, hindi suportado ang mga format ng tulad ng 1-3 o 1,3 para sa sunod-sunod o hindi sunod-sunod na maraming pahina.

  posXfloatfalseOffset sa x-axis, ang kaliwang ibaba ng pahina ang pinagmulan ng koordinado. Ang saklaw ng koordinado ay katulad ng saklaw ng koordinado ng iba pang mga control.
  posYfloatfalseOffset sa y-axis, ang kaliwang ibaba ng pahina ang pinagmulan ng koordinado. Ang saklaw ng koordinado ay katulad ng saklaw ng koordinado ng iba pang mga control.

Halimbawa ng Hiling

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

Mga Parameter ng Tugon

Pangalan ng Parameter

Uri

Paliwanag

code

int

Kode ng negosyo, 0 ay nangangahulugang tagumpay, hindi 0 ay nangangahulugang error.

message

string

Impormasyon ng Negosyo

[Paalala] Mangyaring suriin ang mga error base sa code, huwag umasa sa pag-match ng message dahil maaaring baguhin ang message.

data

object

Data ng Negosyo

Halimbawa ng Tugon

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