Εισαγωγή
Παρέχει RESTful APIs για μετάφραση εγγράφων, υποστηρίζοντας αυτοματοποιημένη διαχείριση εργασιών μετάφρασης, συνέπεια ορολογίας βασισμένη σε γλωσσάριο και ερωτήματα για υποστηριζόμενες μορφές, γλώσσες και μοντέλα, καθιστώντας εύκολη την κατασκευή ομαλών ροών εργασίας μετάφρασης και τη διαχείριση λογαριασμών χρηστών.
Έναρξη
Για να ξεκινήσετε, πρέπει να υποβάλετε αίτηση για να γίνετε προγραμματιστής.Αίτηση ως προγραμματιστής
Μόλις εγκριθεί, μπορείτε να δημιουργήσετε πολλαπλά κλειδιά API και να συμπεριλάβετε το κατάλληλο κλειδί API σε κάθε αίτημα API όπως απαιτείται.
Γρήγορη πρόσβαση
Base URL
https://otranslator.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. Διαχείριση εργασίας
Πληρώστε κατά τη χρήση για πλήρη μετάφραση κειμένου, επανεκκίνηση εργασιών, αναθεώρηση κειμένου ή διαγραφή εργασιών.