Регистрирайте се като разработчик и получете API ключ
Предоставя RESTful API за превод на документи, поддържащи автоматизирано управление на преводни задачи, терминологична консистентност чрез речници и заявки за поддържани формати, езици и модели, което улеснява създаването на безпроблемни работни процеси за превод и управление на потребителски акаунти.
Първи стъпки
За да започнете, трябва да подадете заявление, за да станете разработчик.Кандидатствай като разработчик
След одобрение можете да създадете множество 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 status code.
- 400 Bad Request
- Липсващи задължителни параметри, невалидни формати на параметри или enum стойности, липсващо качване на файл, неуспешно записване на качването или неуспешна обработка на задачата.
- 401 Unauthorized
- Липсващ API ключ или невалиден API ключ.
- 402 Payment Required
- Недостатъчен кредитен баланс за преглед, пълен превод или текстов превод.
- 404 Not Found
- Задачата или речникът не съществува, е изтрита, не принадлежи към текущия API акаунт или не е създадена чрез API.
- 409 Conflict
- Текущото състояние на задачата не позволява исканата операция.
- 500 Internal Server Error
- Неочаквано изключение на сървъра. Грешката в отговора е определена като "Вътрешна грешка на сървъра.".
Препоръчителен процес на интегриране
1. Създаване на задача
Качете файл и създайте задача за превод, връща се taskId.
2. Проверка на прогреса
Проверявайте статуса на задачата, докато стане Completed, Terminated или Cancelled.
3. Получаване на резултат
Изтеглете преведения файл или прочетете оригиналния и преведения JSON.
4. Управление на задачи
Плащане по заявка за пълен превод на текст, рестартиране на задачи, ревизиране на текст или изтриване на задачи.