การจัดการไฟล์

โปรดตรวจสอบหลังจากใช้ API เพื่อรับที่อยู่ไฟล์แล้ว ได้ใช้ URL ที่ได้รับเพื่ออัปโหลดสตรีมไฟล์โดยใช้ HTTP PUT หรือไม่ หากไม่ได้อัปโหลด โปรดเรียก URL เพื่ออัปโหลดไฟล์

ที่อยู่สำหรับอัปโหลดไฟล์มีอายุการใช้งานนานเท่าใด

ที่อยู่สำหรับอัปโหลดไฟล์ ลิงก์มีอายุการใช้งาน 60 นาที

การเชื่อมต่อไซต์อัปโหลดไฟล์ในระหว่างกระบวนการเชื่อมต่อhttps://file-sml.esignglobal.com/ช้ามาก การอัปโหลดไฟล์ค่อนข้างช้า

ข้อควรระวังในการเชื่อมต่อและอัปโหลดไฟล์ในสภาพแวดล้อม Sandbox เซิร์ฟเวอร์ตั้งอยู่ในสิงคโปร์ เมื่อเข้าถึงโดยตรงจากในประเทศ เครือข่ายมักจะไม่เสถียร ปัญหาต่างๆ เช่น การกระตุก การโหลดช้า หรือไม่สามารถเข้าถึงได้เกิดขึ้นเป็นครั้งคราว ด้วยเหตุนี้ ขอแนะนำให้เข้าถึงผ่านพร็อกซีของสิงคโปร์ ซึ่งจะช่วยปรับปรุงสถานการณ์เครือข่ายที่ไม่เสถียร และใช้บริการไฟล์นี้ได้สะดวกยิ่งขึ้น

การเรียก openapi เพื่อรับที่อยู่ไฟล์สำเร็จ แต่การอัปโหลดไฟล์ล้มเหลวในภายหลัง

ขั้นตอนที่ 1: รับที่อยู่สำหรับอัปโหลดไฟล์ ในระหว่างการดำเนินการ คุณต้องให้ข้อมูลที่เกี่ยวข้องในรูปแบบต่อไปนี้เพื่อรับที่อยู่สำหรับอัปโหลดไฟล์: { "fileName": "fengniantest.pdf", "contentType": "application/pdf" } โปรดทราบว่าแม้ว่าชื่อไฟล์จะเป็น “fengniantest.pdf” แต่ประเภทเนื้อหา (contentType) ถูกระบุเป็น “application/pdf” คุณต้องตรวจสอบให้แน่ใจว่าพารามิเตอร์ที่เกี่ยวข้องถูกต้อง

ขั้นตอนที่ 2: เพิ่มข้อมูลส่วนหัวของคำขอเมื่อทำการอัปโหลดไฟล์โดยตรง เมื่อทำการอัปโหลดไฟล์โดยตรง คุณต้องเพิ่มข้อมูล ‘Content-Type: application/pdf’ ในส่วนหัว (headers) เพื่อระบุประเภทของไฟล์ที่อัปโหลด เพื่อให้แน่ใจว่าการอัปโหลดไฟล์โดยตรงสามารถทำได้อย่างราบรื่น

openapi รองรับรูปแบบไฟล์ใดบ้างสำหรับการอัปโหลดไฟล์

รองรับไฟล์ในรูปแบบต่อไปนี้: PDF (.pdf), Word (.docx, .doc), RTF (.rtf), Excel (.xlsx, .xls), PowerPoint (.pptx, .ppt), WPS Writer (.wps), WPS Spreadsheets (.et), WPS Presentation (.dps), JPEG (.jpeg, .jpg), PNG (.png), BMP (.bmp), TIFF (.tiff), GIF (.gif), HTML (.html, .htm) และ CSV (.csv)

ค้นหางานสังเคราะห์ไฟล์ผ่าน taskId และแสดงข้อความ “การแปลงไฟล์ล้มเหลว: ไม่สามารถเข้าถึงที่อยู่เครือข่ายได้”

เมื่อเกิดกรณีที่การแปลงเอกสารหมดเวลา มักจะทำให้การสังเคราะห์ไฟล์ล้มเหลว ในขณะนี้ คุณสามารถเรียกเทมเพลตอีกครั้งเพื่อสร้างไฟล์ จากนั้นเรียกอินเทอร์เฟซการค้นหางานสังเคราะห์ไฟล์เพื่อดูว่าการสังเคราะห์ไฟล์ครั้งนี้สำเร็จหรือไม่ หากหลังจากดำเนินการข้างต้นแล้ว การสังเคราะห์ไฟล์ยังคงล้มเหลว คุณสามารถติดต่อเจ้าหน้าที่ด้านเทคนิคโดยตรงเพื่อให้เจ้าหน้าที่ด้านเทคนิคช่วยเหลือคุณในการแก้ไขปัญหานี้

การเรียกที่อยู่สำหรับอัปโหลดไฟล์และพารามิเตอร์การอัปโหลดไฟล์โดยตรงนั้นถูกต้อง แต่การอัปโหลดไฟล์โดยตรงยังคงรายงาน "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>"

หากพารามิเตอร์ที่ส่งในขั้นตอนที่ 1 คือcontentTypeที่ส่งใน Header ของขั้นตอนที่สองContent-Typeเหมือนกัน และเรียกผ่าน PostmanfileUploadUrlการอัปโหลดไฟล์โดยตรงสำเร็จ แต่เมื่อเรียกผ่านโค้ดยังคงเกิดข้อผิดพลาด หลังจากตรวจสอบจุดพักแล้วพบว่าการส่งพารามิเตอร์ถูกต้อง อาจเป็นไปได้ว่าแอปพลิเคชันเฟรมเวิร์กมีปัญหาด้านความเข้ากันได้ ขอแนะนำให้อ้างอิงตัวอย่างโค้ดต่อไปนี้เพื่ออัปโหลดไฟล์โดยตรง:

อ้างอิงโค้ด:

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

คำอธิบายที่สำคัญ:

การตรวจสอบความสอดคล้องของพารามิเตอร์: ตรวจสอบให้แน่ใจว่าในโค้ดContent-Typeพารามิเตอร์ (เช่น"application/pdf") สอดคล้องกับข้อกำหนดของอินเทอร์เฟซอย่างสมบูรณ์ รวมถึงตัวพิมพ์เล็กตัวพิมพ์ใหญ่และรูปแบบ (เช่นapplication/jsonต้องapplication/JSONแยกความแตกต่างอย่างเคร่งครัด)
การตรวจสอบความเข้ากันได้ของเฟรมเวิร์ก: หากตรรกะของโค้ดถูกต้อง แต่ยังคงเกิดข้อผิดพลาด คุณสามารถลองข้ามเฟรมเวิร์กของลูกค้าและใช้ไคลเอนต์ HTTP ดั้งเดิมโดยตรง (เช่น JavaURLConnectionPythonrequests) เพื่อตรวจสอบว่ามีปัญหาความเข้ากันได้ของเฟรมเวิร์กในการประมวลผลส่วนหัวคำขอและสตรีมไฟล์หรือไม่
การระบุตำแหน่งบันทึกข้อผิดพลาด: ขอแนะนำให้ลูกค้าจับภาพและบันทึกข้อมูลข้อผิดพลาดที่สมบูรณ์ (เช่น รหัสสถานะ HTTP, ข้อความตอบกลับของเซิร์ฟเวอร์) เพื่อตรวจสอบเพิ่มเติมถึงสาเหตุของข้อผิดพลาดเฉพาะในเลเยอร์เครือข่ายหรือฝั่งเซิร์ฟเวอร์

โซลูชันนี้สามารถแยกปัญหาเฟรมเวิร์กได้อย่างมีประสิทธิภาพและระบุสาเหตุหลักของการอัปโหลดไฟล์โดยตรงล้มเหลวได้อย่างรวดเร็ว โดยการทำให้การส่งพารามิเตอร์เป็นมาตรฐานและลดความซับซ้อนของเส้นทางการเรียก