ขั้นตอนการอัปโหลดไฟล์
ขั้นตอนที่หนึ่ง:รับที่อยู่สำหรับอัปโหลดไฟล์ ใช้ FileUpload Url ที่ได้รับจากอินเทอร์เฟซสำหรับรับที่อยู่การอัปโหลดไฟล์โดยตรง
ขั้นตอนที่สอง:อัปโหลดไฟล์ ใช้ URL ที่ได้รับจากขั้นตอนที่หนึ่งเพื่ออัปโหลดสตรีมไฟล์โดยใช้ HTTP PUT
【ข้อควรระวัง】: contentType ที่ส่งในขั้นตอนที่หนึ่งจะต้องสอดคล้องกับ Content-Type ที่ส่งในส่วนหัวของขั้นตอนที่สอง มิฉะนั้น จะเกิดข้อผิดพลาดที่มีรหัสข้อผิดพลาด 403
【ข้อควรระวัง】: contentMD5 ไม่จำเป็นต้องกรอก หากส่ง contentMD5 และ contentType ผ่านขั้นตอนที่หนึ่ง จะต้องส่ง Content-MD5 และ Content-Type ในส่วนหัวของขั้นตอนที่สองด้วย และต้องสอดคล้องกัน
รับที่อยู่สำหรับอัปโหลดไฟล์
POST /esignglobal/v1/files/getUploadUrl
คำอธิบายอินเทอร์เฟซ
รับที่อยู่สำหรับอัปโหลดไฟล์ผ่านอินเทอร์เฟซนี้
พารามิเตอร์คำขอ
ตัวอย่างคำขอ
{
"fileName": "测试.pdf",
"contentType": "application/pdf"
}พารามิเตอร์การตอบสนอง
ตัวอย่างการตอบสนอง
{
"code": "0",
"data": {
"fileKey": "xxxxxxxxx",
"fileName": "签署.pdf",
"fileUploadUrl": "文件上传地址"
},
"message": "成功"
}
อัปโหลดไฟล์
URL fileUpload ที่ได้รับจากอินเทอร์เฟซ “รับที่อยู่สำหรับอัปโหลดไฟล์”
คำอธิบายอินเทอร์เฟซ
ใช้วิธีการร้องขอ PUT เพื่ออัปโหลดสตรีมไฟล์ (สตรีมไบต์ไบนารี) ไปยังฝั่งเซิร์ฟเวอร์ผ่าน fileUpload Url (ที่อยู่สำหรับอัปโหลดไฟล์) ที่ได้รับ
พารามิเตอร์คำขอ
1. ส่วนหัว
2. HTTP BODY:สตรีมไบต์ไบนารีของไฟล์ที่จะอัปโหลด
3. วิธีการเข้ารหัส:
ตัวอย่างคำขอ
fileName = URLEncoder.encode(fileName, "UTF-8");
// replace special characters
fileName = fileName
.replaceAll("\\+", "%20")
.replaceAll("%28", "(")
.replaceAll("%29", ")")
.replaceAll("%27", "'")
.replaceAll("%21", "!")
.replaceAll("%7E", "~");ตัวอย่างการตอบสนอง
http_status: 200
