บทนำ
ให้บริการ RESTful APIs สำหรับการแปลเอกสาร รองรับการจัดการงานแปลอัตโนมัติ ความสอดคล้องของศัพท์เฉพาะตาม glossary และการสอบถามรูปแบบ ภาษา และโมเดลที่รองรับ ทำให้สามารถสร้างเวิร์กโฟลว์การแปลที่ราบรื่นและจัดการบัญชีผู้ใช้ได้อย่างง่ายดาย
การเริ่มต้นใช้งาน
ในการเริ่มต้น ท่านจำเป็นต้องสมัครเป็นนักพัฒนาสมัครเป็นนักพัฒนา
เมื่อได้รับอนุมัติแล้ว คุณสามารถสร้าง API keys หลายตัวและใส่ API key ที่เหมาะสมในแต่ละคำขอ API ตามที่จำเป็น
เชื่อมต่อด่วน
Base URL
https://dltranslator.com/api
วิธีการรับรอง
Authorization: [yourSecretKey]
คำขอ JSON
นอกจากอินเทอร์เฟซอัปโหลดไฟล์ อินเทอร์เฟซจะใช้คำขอ POST JSON โดยค่าเริ่มต้น โดย Content-Type เป็น application/json
อัปโหลดไฟล์
การสร้างงานแปลเอกสารใช้ multipart/form-data โดยส่งไฟล์ที่ต้องการแปลผ่านฟิลด์ file
การตอบสนองข้อผิดพลาดทั่วไป
เมื่อคำขอล้มเหลว interface จะส่งกลับ JSON โดยฟิลด์ error จะมีข้อความแสดงข้อผิดพลาดเป็นภาษาอังกฤษที่คงที่แนะนำให้จัดการข้อผิดพลาดตาม HTTP status code เป็นหลัก โดยใช้ฟิลด์ error สำหรับการแสดงผลหรือบันทึกใน log
{
"error": "Invalid API key."
}กฎรหัสสถานะข้อผิดพลาด
การตอบสนองข้อผิดพลาดของ v1 API ทั้งหมดคงโครงสร้างเดียวกัน โปรดจัดการตามกฎรหัสสถานะ HTTP ต่อไปนี้
- 400 Bad Request
- Missing required parameters, invalid parameter formats or enum values, missing file upload, upload save failure, or task processing failure.
- 401 Unauthorized
- Missing API key or invalid API key.
- 402 Payment Required
- Insufficient credits balance for preview, full translation, or text translation.
- 404 Not Found
- The task or glossary does not exist, has been deleted, does not belong to the current API account, or was not created through the API.
- 409 Conflict
- The current task status does not allow the requested operation.
- 500 Internal Server Error
- Unexpected server exception. The response error is fixed as "Internal server error.".
กระบวนการเชื่อมต่อที่แนะนำ
1. สร้างงาน
อัปโหลดไฟล์และสร้างงานแปล คืนค่า taskId
2. ตรวจสอบความคืบหน้า
polling สถานะงานจนกว่าจะเป็น Completed, Terminated หรือ Cancelled
3. รับผลลัพธ์
ดาวน์โหลดไฟล์แปล หรืออ่านไฟล์ JSON ของต้นฉบับและคำแปล
4. จัดการงาน
จ่ายตามการใช้งานสำหรับการแปลฉบับเต็ม การเริ่มงานใหม่ การแก้ไขข้อความ หรือการลบงาน