Muat naik fail

Langkah-langkah Memuat Naik Fail

Langkah Satu:Dapatkan Alamat Muat Naik Fail。Gunakan URL fileUpload yang diperoleh daripada antara muka mendapatkan alamat muat naik fail langsung。

Langkah Dua:Muat Naik Fail。Muat naik aliran fail menggunakan kaedah HTTP PUT melalui URL yang diperoleh dalam langkah satu。

【Perhatian】: contentType yang dihantar dalam langkah satu mesti konsisten dengan Content-Type yang dihantar dalam Header dalam langkah dua, jika tidak, ralat dengan kod ralat 403 akan berlaku。

【Perhatian】: contentMD5 bukan item yang wajib diisi. Jika contentMD5 dan contentType dihantar melalui langkah satu, Content-MD5 dan Content-Type juga mesti dihantar dalam Header langkah dua, dan kekal konsisten

Dapatkan Alamat Muat Naik Fail

POST /esignglobal/v1/files/getUploadUrl

Penerangan Antara Muka

Dapatkan alamat muat naik fail melalui antara muka ini

Parameter Permintaan

Nama Parameter	Jenis	Wajib Diisi	Keterangan
fileName	string	true	Nama Fail 【Perhatian】: Mesti disertakan dengan sambungan fail, jika tidak, ia akan menyebabkan sampul surat seterusnya gagal melalui pengesahan. Contoh: NamaKontrak1.pdf Keterangan Tambahan: (1) Akhiran nama fail medan ini mesti konsisten dengan akhiran fail sebenar. Contohnya, jika jenis fail yang dimuat naik ialah fail PDF, maka parameter ini perlu dihantar sebagai "xxx.pdf", bukan "xxx.docx". (2) Nama fail tidak boleh mengandungi 9 aksara khas berikut: /\:*"<>\|? dan semua emoji (3) Hanya format fail .pdf disokong
contentMD5	string	false	Nilai Content-MD5 fail Keterangan Tambahan: Anda perlu mendapatkan tatasusunan binari 128-bit MD5 fail terlebih dahulu, dan kemudian melakukan pengekodan Base64 pada binari ini. 【Perhatian】Jika nilai parameter ini dihantar, Content-MD5 fail yang dimuat naik dalam langkah kedua juga mesti menghantar nilai yang sama
contentType	string	true	Jenis Kandungan 【Perhatian】Jenis Kandungan fail yang dimuat naik dalam langkah kedua juga mesti menghantar nilai yang sama

Contoh Permintaan

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

Parameter Respons

Nama Parameter	Jenis	Keterangan
fileKey	string	fileKey Fail
fileName	string	Nama Fail
fileUploadUrl	string	Alamat muat naik fail, sah dalam masa 60 minit 【Perhatian】 Sila minta semula antara muka untuk mendapatkan alamat muat naik selepas tamat tempoh

Contoh Respons

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

Muat Naik Fail

URL fileUpload yang diperoleh melalui antara muka "Dapatkan Alamat Muat Naik Fail".

Perihalan Antara Muka

Gunakan kaedah permintaan PUT untuk memuat naik aliran fail (aliran bait binari) ke pelayan melalui URL fileUpload (alamat muat naik fail) yang telah diperoleh.

Parameter Permintaan

1. Headers

Nama Parameter

Jenis

Diperlukan

Keterangan

Content-MD5

string

false

Sama dengan nilai contentMD5 dalam Body 【Dapatkan Alamat Muat Naik Fail】

Content-Type

string

true

Jenis MIME fail sasaran

Catatan Tambahan:

Boleh diisi dengan application/octet-stream atau application/pdf, perlu sama dengan parameter permintaan antara muka dapatkan alamat muat naik

2. HTTP BODY:Strim bait binari fail yang hendak dimuat naik

3. Kaedah encode:

Contoh Permintaan

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

Contoh Respons

http_status: 200