מבוא
מספק ממשקי API מסוג RESTful לתרגום מסמכים, תומך בניהול משימות תרגום אוטומטיות, עקביות טרמינולוגית מבוססת מילון מונחים, ושאילתות לפורמטים נתמכים, שפות ומודלים, מה שמאפשר בניית תהליכי עבודה חלקים לתרגום וניהול חשבונות משתמש.
תחילת העבודה
כדי להתחיל, עליכם להגיש בקשה להפוך למפתחים.הגש מועמדות כמפתח
לאחר האישור, ניתן ליצור מפתחות API מרובים ולכלול את מפתח ה-API המתאים בכל בקשת API כנדרש.
גישה מהירה
Base URL
https://dltranslator.com/api
שיטת אימות
Authorization: [yourSecretKey]
בקשת JSON
מלבד ממשק העלאת קבצים, ממשקים משתמשים כברירת מחדל בבקשות POST JSON, כאשר Content-Type הוא application/json.
העלאת קובץ
יצירת משימת תרגום מסמכים משתמשת ב-multipart/form-data, שדה file מעביר את הקובץ המיועד לתרגום.
תגובת שגיאה כללית
כאשר הבקשה נכשלת, הממשק יחזיר JSON, שדה error מכיל מידע שגיאה קבוע באנגלית. מומלץ לטפל בשגיאות בעדיפות על פי HTTP status code, שדה error משמש להצגה או לרישום ביומן.
{
"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. בדיקת התקדמות
ביצוע בדיקה מחזורית של סטטוס המשימה עד להשגת Completed, Terminated או Cancelled.
3. קבלת תוצאות
הורדת קובץ מתורגם, או קריאת JSON של המקור והתרגום.
4. ניהול משימות
תשלום לפי דרישה עבור תרגום טקסט מלא, הפעלה מחדש של משימה, תיקון טקסט או מחיקת משימה.