Εγγραφείτε ως Προγραμματιστής και Αποκτήστε ένα Κλειδί API
Παρέχει RESTful APIs για μετάφραση εγγράφων, υποστηρίζοντας αυτοματοποιημένη διαχείριση εργασιών μετάφρασης, συνέπεια ορολογίας βασισμένη σε γλωσσάριο και ερωτήματα για υποστηριζόμενες μορφές, γλώσσες και μοντέλα, καθιστώντας εύκολη την κατασκευή ομαλών ροών εργασίας μετάφρασης και τη διαχείριση λογαριασμών χρηστών.
Έναρξη
Για να ξεκινήσετε, πρέπει να υποβάλετε αίτηση για να γίνετε προγραμματιστής.Αίτηση ως προγραμματιστής
Μόλις εγκριθεί, μπορείτε να δημιουργήσετε πολλαπλά κλειδιά API και να συμπεριλάβετε το κατάλληλο κλειδί API σε κάθε αίτημα API όπως απαιτείται.
Γρήγορη πρόσβαση
Βασικό URL
https://shangyiai.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
- Λείπουν απαιτούμενες παράμετροι, μη έγκυρες μορφές παραμέτρων ή τιμές enum, λείπει μεταφόρτωση αρχείου, αποτυχία αποθήκευσης μεταφόρτωσης ή αποτυχία επεξεργασίας εργασίας.
- 401 Unauthorized
- Το κλειδί API λείπει ή δεν είναι έγκυρο.
- 402 Payment Required
- Ανεπαρκές υπόλοιπο πίστωσης για προεπισκόπηση, πλήρη μετάφραση ή μετάφραση κειμένου.
- 404 Not Found
- Η εργασία ή το γλωσσάριο δεν υπάρχει, έχει διαγραφεί, δεν ανήκει στον τρέχοντα λογαριασμό API ή δεν δημιουργήθηκε μέσω του API.
- 409 Conflict
- Η τρέχουσα κατάσταση της εργασίας δεν επιτρέπει τη ζητούμενη λειτουργία.
- 500 Internal Server Error
- Μη αναμενόμενη εξαίρεση διακομιστή. Το σφάλμα απόκρισης είναι καθορισμένο ως "Εσωτερικό σφάλμα διακομιστή.".
Προτεινόμενη διαδικασία ενσωμάτωσης
1. Δημιουργία εργασίας
Ανεβάστε αρχείο και δημιουργήστε εργασία μετάφρασης, επιστρέφει taskId.
2. Έλεγχος προόδου
Επανάληψη ελέγχου της κατάστασης της εργασίας, μέχρι να γίνει Completed, Terminated ή Cancelled.
3. Λήψη αποτελεσμάτων
Κατεβάστε το μεταφρασμένο αρχείο ή διαβάστε το JSON με το πρωτότυπο και τη μετάφραση.
4. Διαχείριση εργασίας
Πληρώστε κατά τη χρήση για πλήρη μετάφραση κειμένου, επανεκκίνηση εργασιών, αναθεώρηση κειμένου ή διαγραφή εργασιών.