Pusat Layanan
Home

Manajemen File

Kesalahan saat menambahkan file, fileKey tidak ada, melaporkan “File cannot be found.”

Harap periksa setelah menggunakan antarmuka untuk mendapatkan alamat file untuk mendapatkan URL unggah file, apakah Anda menggunakan URL yang diperoleh untuk mengunggah aliran file menggunakan metode HTTP PUT. Jika Anda belum mengunggah, harap panggil URL untuk mengunggah file.

 

Berapa lama masa berlaku alamat unggah file?

Alamat unggah file, tautanMasa berlaku koneksi adalah 60 menit.

 

 

Situs unggah file selama proses koneksihttps://file-sml.esignglobal.com/Sangat lambat, unggah file sangat lambat

Perhatikan bahwa saat menghubungkan dan mengunggah file di lingkungan sandbox, servernya berlokasi di Singapura. Saat mengakses langsung dari Tiongkok, jaringan seringkali tidak stabil, dan masalah seperti jeda, pemuatan lambat, atau tidak dapat diakses sering terjadi. Mengingat hal ini, disarankan untuk mengakses melalui proxy Singapura, yang akan membantu meningkatkan ketidakstabilan jaringan dan membuat penggunaan layanan file ini lebih mudah.

 

 

Gagal mengunggah file setelah panggilan openapi untuk mendapatkan alamat file berhasil

Langkah 1: Dapatkan Alamat Unggah File Dalam proses operasi, Anda perlu memberikan informasi terkait dalam format berikut untuk mendapatkan alamat unggah file: { "fileName": "fengniantest.pdf", "contentType": "application/pdf" } Harap perhatikan bahwa meskipun nama file di sini adalah "fengniantest.pdf", jenis konten (contentType) ditentukan sebagai "application/pdf", pastikan parameter terkait akurat. 

Langkah 2: Tambahkan informasi header permintaan saat melakukan pengunggahan file langsung Saat melakukan operasi pengunggahan file langsung, Anda harus menambahkan informasi 'Content-Type: application/pdf' ke header permintaan (headers) untuk memperjelas jenis file yang diunggah dan memastikan operasi pengunggahan file langsung dapat berjalan dengan lancar.

 

 

Format file apa saja yang didukung oleh unggah file openapi?

File dengan format berikut didukung: PDF (.pdf), Word (.docx, .doc), RTF (.rtf), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt), WPS Text (.wps), WPS Spreadsheet (.et), WPS Presentation (.dps), JPEG (.jpeg, .jpg), PNG (.png), BMP (.bmp), TIFF (.tiff), GIF (.gif), HTML (.html, .htm), dan format CSV (.csv).

 

 

 

Mencari tugas sintesis file melalui taskId, muncul pesan "Konversi file gagal: Akses alamat jaringan gagal"

Ketika konversi dokumen mengalami timeout, sering kali menyebabkan sintesis file gagal. Pada saat ini, Anda dapat memanggil kembali templat untuk menghasilkan file, lalu memanggil antarmuka tugas sintesis file untuk melihat apakah sintesis file berhasil kali ini. Jika setelah operasi di atas, sintesis file masih gagal, maka Anda dapat langsung menghubungi staf teknis untuk membantu Anda memecahkan masalah ini.

 

 

Memanggil alamat unggah file dan parameter unggah file langsung sudah benar, tetapi unggah file langsung masih melaporkan "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>"

Jika parameter yang diteruskan pada langkah pertama adalahcontentTypeSesuai dengan yang ditransmisikan di Header Langkah KeduaContent-Typekonsisten, dan dipanggil melalui PostmanfileUploadUrlUnggahan langsung file berhasil, tetapi kode masih melaporkan kesalahan saat dipanggil. Setelah memeriksa titik henti, transfer parameter benar. Mungkin ada masalah kompatibilitas dengan aplikasi kerangka kerja. Disarankan untuk merujuk ke contoh kode berikut untuk unggahan langsung file:

Contoh kode:

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

Penjelasan penting:

  1. Verifikasi konsistensi parameter: Pastikan dalam kodeContent-Typeparameter (seperti"application/pdf") sepenuhnya konsisten dengan persyaratan antarmuka, termasuk huruf besar/kecil dan format (sepertiapplication/jsonharus dibedakan secara ketat dariapplication/JSON).
  2. Penyelidikan kompatibilitas kerangka kerja: Jika logika kode benar tetapi masih melaporkan kesalahan, Anda dapat mencoba melewati kerangka kerja pelanggan dan langsung menggunakan klien HTTP asli (seperti JavaURLConnection, Pythonrequests) untuk memverifikasi apakah ada masalah kompatibilitas dengan pemrosesan header permintaan dan aliran file oleh kerangka kerja.
  3. Lokalisasi log kesalahan: Pelanggan disarankan untuk menangkap dan mencatat informasi kesalahan lengkap (seperti kode status HTTP, pesan respons server) untuk penyelidikan lebih lanjut tentang penyebab kesalahan spesifik di lapisan jaringan atau sisi server.

Solusi ini, dengan menstandarisasi transfer parameter dan menyederhanakan jalur panggilan, dapat secara efektif mengisolasi masalah kerangka kerja dan dengan cepat menemukan akar penyebab kegagalan unggahan langsung file.

    Tautan: