Unggah Berkas

Langkah-langkah Mengunggah File

Langkah 1:Dapatkan Alamat Unggah File. Gunakan fileUpload Url yang didapatkan dari antarmuka untuk mendapatkan alamat unggah file langsung.

Langkah 2:Unggah File. Unggah aliran file menggunakan metode HTTP PUT melalui URL yang didapatkan pada langkah pertama.

[Perhatian]: contentType yang ditransmisikan pada langkah pertama harus konsisten dengan Content-Type yang ditransmisikan di Header pada langkah kedua, jika tidak, akan terjadi kesalahan dengan kode kesalahan 403.

[Perhatian]: contentMD5 bukan merupakan item wajib diisi. Jika contentMD5 dan contentType ditransmisikan melalui langkah pertama, Content-MD5 dan Content-Type juga harus ditransmisikan di Header langkah kedua, dan harus tetap konsisten

Dapatkan Alamat Unggah File

POST /esignglobal/v1/files/getUploadUrl

Deskripsi Antarmuka

Dapatkan alamat unggah file melalui antarmuka ini

Parameter Permintaan

Nama Parameter	Jenis	Wajib diisi	Keterangan
fileName	string	true	Nama File 【Catatan】: Harus menyertakan ekstensi file, jika tidak, validasi amplop berikutnya tidak akan berhasil. Contoh: NamaKontrak1.pdf Keterangan tambahan: (1) Ekstensi nama file di kolom ini harus sesuai dengan ekstensi file yang sebenarnya. Misalnya, jika jenis file yang diunggah adalah file PDF, maka parameter ini harus mengirimkan "xxx.pdf", bukan "xxx.docx". (2) Nama file tidak boleh mengandung 9 karakter khusus berikut: /\:*"<>\|? dan semua emoji (3) Hanya mendukung format file .pdf
contentMD5	string	false	Nilai Content-MD5 dari file Keterangan tambahan: Anda harus terlebih dahulu mendapatkan array biner 128-bit dari MD5 file, lalu melakukan encoding Base64 pada biner ini. 【Catatan】Jika nilai parameter ini ditransmisikan, Content-MD5 dari file yang diunggah pada langkah kedua juga harus mengirimkan nilai yang sama
contentType	string	true	Jenis konten 【Catatan】Content-Type dari file yang diunggah pada langkah kedua juga harus mengirimkan nilai yang sama

Contoh Permintaan

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

Parameter Respons

Nama Parameter	Jenis	Deskripsi
fileKey	string	File fileKey
fileName	string	Nama File
fileUploadUrl	string	Alamat unggah file, berlaku dalam 60 menit 【Perhatian】 Setelah kedaluwarsa, harap minta ulang antarmuka untuk mendapatkan alamat unggah

Contoh Respons

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

Unggah File

URL fileUpload yang diperoleh melalui antarmuka "Dapatkan alamat unggah file".

Deskripsi Antarmuka

Melalui fileUpload Url (alamat unggah file) yang telah diperoleh, gunakan metode permintaan PUT untuk mengunggah aliran file (aliran byte biner) ke server.

Parameter Permintaan

1. Header

Nama Parameter

Tipe

Wajib

Keterangan

Content-MD5

string

false

Sesuai dengan nilai contentMD5 di Body pada 【Dapatkan Alamat Unggah File】

Content-Type

string

true

Tipe MIME dari file target

Catatan Tambahan:

Dapat diisi dengan application/octet-stream atau application/pdf, harus sesuai dengan parameter permintaan dari antarmuka dapatkan alamat unggah

2. HTTP BODY:Aliran byte biner dari file yang akan diunggah

3. Metode 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