Trung tâm dịch vụ

Quản lý tập tin

Lỗi thêm tệp báo fileKey không tồn tại, báo “File cannot be found.

Vui lòng kiểm tra sau khi sử dụng giao diện lấy địa chỉ tệp để lấy URL fileUpload, bạn đã sử dụng URL lấy được để tải lên luồng tệp bằng phương thức HTTP PUT chưa, nếu chưa tải lên, vui lòng gọi URL để tải tệp lên.

 

Địa chỉ tải tệp lên có hiệu lực trong bao lâu?

Địa chỉ tải tệp lên, chuỗiThời gian hiệu lực của kết nối là 60 phút.

 

 

Trang web tải tệp lên trong quá trình kết nốihttps://file-sml.esignglobal.com/Đặc biệt chậm, tải tệp lên tương đối chậm

Cần lưu ý khi tải tệp lên môi trường sandbox, máy chủ của nó được đặt tại Singapore, khi truy cập trực tiếp từ Trung Quốc, mạng thường không ổn định, các vấn đề như giật lag, tải chậm hoặc không thể truy cập thường xuyên xảy ra. Do đó, bạn nên truy cập thông qua proxy của Singapore, điều này sẽ giúp cải thiện tình trạng mạng không ổn định và sử dụng dịch vụ tệp này thuận tiện hơn.

 

 

openapi gọi lấy địa chỉ tệp thành công sau đó tải tệp lên không thành công

Bước 1: Lấy địa chỉ tải lên tệp Trong quá trình thao tác, bạn cần cung cấp thông tin liên quan theo định dạng sau để lấy địa chỉ tải lên tệp: { "fileName": "fengniantest.pdf", "contentType": "application/pdf" } Xin lưu ý rằng mặc dù tên tệp ở đây là “fengniantest.pdf”, nhưng loại nội dung (contentType) được chỉ định là “application/pdf”, bạn cần đảm bảo rằng các tham số liên quan là chính xác. 

Bước 2: Thêm thông tin tiêu đề yêu cầu khi tải trực tiếp tệp Khi thực hiện thao tác tải trực tiếp tệp, bạn cần thêm thông tin ‘Content-Type: application/pdf’ vào tiêu đề (headers) để xác định rõ loại tệp tải lên, đảm bảo thao tác tải trực tiếp tệp có thể diễn ra suôn sẻ.

 

 

Openapi tải lên tệp hỗ trợ những định dạng tệp nào?

Hỗ trợ các định dạng tệp sau: PDF (.pdf), Word (.docx, .doc), RTF (.rtf), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt), WPS文字 (.wps), WPS表格 (.et), WPS演示 (.dps), JPEG (.jpeg, .jpg), PNG (.png), BMP (.bmp), TIFF (.tiff), GIF (.gif), HTML (.html, .htm) và CSV (.csv).

 

 

 

Thông qua taskId để truy vấn nhiệm vụ tổng hợp tệp,提示“文件转换失败:网络地址访问失败”

Khi xảy ra tình trạng chuyển đổi tài liệu hết thời gian, thường sẽ dẫn đến việc tổng hợp tệp không thành công. Lúc này, bạn có thể gọi lại mẫu để tạo tệp, sau đó gọi giao diện truy vấn nhiệm vụ tổng hợp tệp để xem lần tổng hợp tệp này có thành công hay không. Nếu sau khi thực hiện các thao tác trên mà việc tổng hợp tệp vẫn không thành công, thì bạn có thể liên hệ trực tiếp với nhân viên kỹ thuật để được hỗ trợ giải quyết vấn đề này.

 

 

Gọi địa chỉ tải lên tệp và các tham số tải trực tiếp tệp đều chính xác, nhưng tải trực tiếp tệp vẫn báo lỗi "403 Forbidden: "<?xml version="1.0" encoding="UTF-8"?><EOL><Error><EOL> <Code>SignatureDoesNotMatch</Code><EOL> <Message>The request signature we calculated does not match the signature you provided. Check your key and signing method.</Message><EOL> <RequestId>68440537821143343409E1E9</RequestId><EOL>"

Nếu tham số trong bước một làcontentTypeGiống với thông tin được truyền trong Header ở bước haiContent-Typevà gọi thành công qua PostmanfileUploadUrlTải trực tiếp tệp lên thành công, nhưng vẫn báo lỗi khi gọi bằng code. Sau khi kiểm tra điểm dừng, việc truyền tham số không có lỗi, có thể là do ứng dụng framework có vấn đề về khả năng tương thích. Bạn nên tham khảo các ví dụ code sau để tải trực tiếp tệp lên:

Tham khảo code:

// 调用方式(以Java为例)
Response response = HttpUtil.sendRequest(
    "uploadUrl",                // 上传接口URL
    new File("文件路径/xxx.pdf"), // 待上传文件
    "application/pdf",          // 内容类型
    new HashMap<>()             // 可选请求头参数(若无则传空)
);

Giải thích quan trọng:

  1. Xác minh tính nhất quán của tham số: Đảm bảo rằng trong code,Content-Typecác tham số (như"application/pdf") hoàn toàn giống với yêu cầu của giao diện, bao gồm cả chữ hoa chữ thường và định dạng (ví dụ:application/jsonphải được phân biệt nghiêm ngặt vớiapplication/JSON).
  2. Kiểm tra khả năng tương thích của framework: Nếu logic code không có lỗi nhưng vẫn báo lỗi, bạn có thể thử bỏ qua framework của khách hàng và sử dụng trực tiếp HTTP client gốc (ví dụ: của Java làURLConnection, của Python làrequests) để xác minh, xác định xem có phải là vấn đề về khả năng tương thích của framework đối với việc xử lý tiêu đề yêu cầu và luồng tệp hay không.
  3. Xác định vị trí nhật ký lỗi: Khách hàng nên thu thập và ghi lại thông tin lỗi đầy đủ (chẳng hạn như mã trạng thái HTTP, thông báo trả về của máy chủ) để điều tra thêm nguyên nhân gây ra lỗi cụ thể ở lớp mạng hoặc phía máy chủ.

Giải pháp này có thể cách ly hiệu quả các vấn đề về framework và nhanh chóng xác định nguyên nhân gốc rễ của việc tải trực tiếp tệp lên không thành công bằng cách chuẩn hóa việc truyền tham số và đơn giản hóa đường dẫn gọi.