Mag-upload ng file

Mga Hakbang sa Pag-upload ng File

Hakbang Isa:Kunin ang Address ng Pag-upload ng File . Gamitin ang fileUpload Url na nakuha sa pamamagitan ng interface para sa pagkuha ng direktang address ng pag-upload ng file.

Hakbang Dalawa:Mag-upload ng File . Gamitin ang URL na nakuha sa Hakbang Isa upang mag-upload ng file stream gamit ang HTTP PUT method.

【Pansin】：Ang contentType na ipinadala sa Hakbang Isa ay dapat na pareho sa Content-Type na ipinadala sa Header sa Hakbang Dalawa, kung hindi, magkakaroon ng error code na 403.

【Pansin】：Ang contentMD5 ay hindi kinakailangan. Kung nagpadala ka ng contentMD5 at contentType sa Hakbang Isa, dapat mo ring ipadala ang Content-MD5 at Content-Type sa Headers sa Hakbang Dalawa, at panatilihing pareho ang mga ito

Kunin ang Address ng Pag-upload ng File

POST /esignglobal/v1/files/getUploadUrl

Paglalarawan ng Interface

Gamitin ang interface na ito upang kunin ang address ng pag-upload ng file

Mga Parameter ng Kahilingan

Pangalan ng Parameter	Uri	Kinakailangan	Paglalarawan
fileName	string	true	Pangalan ng File 【Pansin】：Dapat isama ang file extension, kung hindi, ang kasunod na paglulunsad ng envelope ay hindi makakapasa sa pag-verify. Halimbawa: Pangalan ng Kontrata1.pdf Karagdagang paliwanag: （1）Ang file suffix name ng field na ito at ang tunay na file suffix ay dapat na pareho. Halimbawa, kung ang uri ng file na ina-upload ay isang PDF file, ang parameter na ito ay dapat na ipasa bilang "xxx.pdf", hindi "xxx.docx". （2）Ang pangalan ng file ay hindi maaaring maglaman ng sumusunod na 9 na espesyal na karakter: /\:*"<>\|? at lahat ng emoji （3）Sinusuportahan lamang ang .pdf file format
contentMD5	string	false	Content-MD5 value ng file Karagdagang paliwanag: Kinakailangan munang kunin ang 128-bit binary array ng MD5 ng file, at pagkatapos ay i-Base64 encode ang binary na ito. 【Pansin】Kung ang parameter na ito ay nagpapadala ng value, ang Content-MD5 ng file na ina-upload sa hakbang dalawa ay dapat ding magpadala ng parehong value
contentType	string	true	Uri ng Nilalaman 【Pansin】Ang Content-Type ng file na ina-upload sa hakbang dalawa ay dapat ding magpadala ng parehong value

Halimbawa ng Kahilingan

{
  "fileName": "测试.pdf",
  "contentType": "application/pdf"
}

Mga Parameter ng Tugon

Pangalan ng Parameter	Uri	Paglalarawan
fileKey	string	File fileKey
fileName	string	Pangalan ng File
fileUploadUrl	string	Address ng pag-upload ng file, may bisa sa loob ng 60 minuto 【Pansin】 Mangyaring humiling muli ng interface upang makuha ang address ng pag-upload pagkatapos mag-expire

Halimbawa ng Tugon

{
    "code": "0",
    "data": {
    "fileKey": "xxxxxxxxx",
      "fileName": "签署.pdf",
      "fileUploadUrl": "文件上传地址"
  },
  "message": "成功"
}

Mag-upload ng File

Ang fileUpload Url na nakuha sa pamamagitan ng interface na "Kumuha ng address ng pag-upload ng file".

Paglalarawan ng Interface

Sa pamamagitan ng nakuha nang fileUpload Url (address ng pag-upload ng file), gamitin ang paraan ng kahilingan na PUT upang i-upload ang file stream (binary byte stream) sa server.

Mga Parameter ng Kahilingan

1. Mga Header

Pangalan ng Parameter

Uri

Kinakailangan

Paglalarawan

Content-MD5

string

false

Kapareho ng contentMD5 value sa Body ng 【Kumuha ng Address para sa Pag-upload ng File】

Content-Type

string

true

Uri ng MIME ng target na file

Karagdagang paliwanag:

Maaaring punan ng application/octet-stream o application/pdf, kinakailangang kapareho ng mga parameter ng kahilingan ng interface para sa pagkuha ng address ng pag-upload

2. HTTP BODY:Binary byte stream ng file na ia-upload

3. Paraan ng pag-encode:

Halimbawa ng Kahilingan

fileName = URLEncoder.encode(fileName, "UTF-8");
// replace special characters
fileName = fileName
  .replaceAll("\\+", "%20")
  .replaceAll("%28", "(")
  .replaceAll("%29", ")")
  .replaceAll("%27", "'")
  .replaceAll("%21", "!")
  .replaceAll("%7E", "~");

Halimbawa ng Tugon

http_status: 200