Tải lên tập tin

Các bước tải lên tệp

Bước 1:Lấy địa chỉ tải lên tệp. Sử dụng fileUpload Url thu được từ giao diện lấy địa chỉ tải lên trực tiếp tệp.

Bước 2:Tải lên tệp. Sử dụng URL thu được từ bước 1 để tải lên luồng tệp bằng phương thức HTTP PUT.

[Lưu ý]: contentType được truyền trong bước 1 phải nhất quán với Content-Type được truyền trong Header của bước 2, nếu không sẽ xảy ra lỗi với mã lỗi 403.

[Lưu ý]: contentMD5 không bắt buộc. Nếu contentMD5 và contentType được truyền qua bước 1, thì Content-MD5 và Content-Type cũng phải được truyền trong Headers của bước 2 và phải nhất quán

Lấy địa chỉ tải lên tệp

POST /esignglobal/v1/files/getUploadUrl

Mô tả giao diện

Lấy địa chỉ tải lên tệp thông qua giao diện này

Tham số yêu cầu

Tên tham số	Loại	Bắt buộc	Mô tả
fileName	string	true	Tên tệp 【Lưu ý】: Phải có phần mở rộng của tệp, nếu không sẽ dẫn đến việc khởi tạo phong bì tiếp theo không vượt qua được xác minh. Ví dụ: Tên hợp đồng 1.pdf Giải thích bổ sung: （1）Tên hậu tố tệp của trường này phải nhất quán với hậu tố tệp thực tế. Ví dụ: nếu loại tệp được tải lên là tệp PDF, thì tham số này cần được truyền là “xxx.pdf”, không phải là “xxx.docx”. （2）Tên tệp không được chứa 9 ký tự đặc biệt sau: /\:*"<>\|? và tất cả các biểu tượng cảm xúc emoji （3）Chỉ hỗ trợ định dạng tệp .pdf
contentMD5	string	false	Giá trị Content-MD5 của tệp Giải thích bổ sung: Cần lấy mảng nhị phân 128 bit của MD5 của tệp trước, sau đó mã hóa Base64 cho nhị phân này. 【Lưu ý】Nếu giá trị tham số này được truyền, Content-MD5 của tệp được tải lên trong bước hai cũng phải truyền cùng giá trị
contentType	string	true	Loại nội dung 【Lưu ý】Content-Type của tệp được tải lên trong bước hai cũng phải truyền cùng giá trị

Ví dụ yêu cầu

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

Tham số phản hồi

Tên tham số	Loại	Mô tả
fileKey	string	fileKey của tệp
fileName	string	Tên tệp
fileUploadUrl	string	Địa chỉ tải tệp lên, có hiệu lực trong 60 phút 【Lưu ý】 Vui lòng yêu cầu lại giao diện để lấy địa chỉ tải lên sau khi hết hạn

Ví dụ phản hồi

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

Tải tệp lên

Thông qua URL fileUpload thu được từ giao diện “Lấy địa chỉ tải tệp lên”.

Mô tả giao diện

Thông qua URL fileUpload (địa chỉ tải tệp lên) đã lấy được, sử dụng phương thức yêu cầu PUT để tải luồng tệp (luồng byte nhị phân) lên máy chủ.

Tham số yêu cầu

1. Headers

Tên tham số

Loại

Bắt buộc

Mô tả

Content-MD5

string

false

Phải giống với giá trị contentMD5 trong Body của 【Lấy địa chỉ tải lên tập tin】

Content-Type

string

true

Loại MIME của tập tin đích

Giải thích bổ sung:

Có thể điền application/octet-stream hoặc application/pdf, cần phải thống nhất với tham số yêu cầu của giao diện lấy địa chỉ tải lên

2. HTTP BODY:Luồng byte nhị phân của tập tin cần tải lên

3. Phương pháp mã hóa:

Ví dụ yêu cầu

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

Ví dụ phản hồi

http_status: 200