Поделиться через

Получение сведений о поддерживаемых форматах глоссария

Справочная
функция: AZURE Translator → ВЕРСИЯ API перевода
документов: метод HTTP 2024-05-01
: GET

Этот метод возвращает список форматов глоссарий, поддерживаемых функцией перевода документов. Список включает общие расширения файлов.

Запросить URL-адрес

Внимание

Для всех запросов API к функции перевода документов требуется конечная точка личного домена, расположенная на странице обзора ресурсов на портале Azure.

curl -i -X GET "{document-translation-endpoint}/translator/document/formats?api-version={date}&type=glossary"

Заголовки запросов

Заголовки запроса.

Заголовки Описание Условие
Ocp-Apim-Subscription-Key Ключ API переводчика на портале Azure. Обязательный
Ocp-Apim-Subscription-Region Регион, в котором был создан ресурс. Требуется при использовании регионального (географического) ресурса, например западной части США.
&маркер.
Тип содержимого Тип содержимого для полезных данных. Допустимые значения: application/json или charset=UTF-8. Обязательный

Коды состояния ответа

Ниже приведены возможные коды состояния HTTP, которые возвращает запрос.

Код состояния Описание
200 ОК. Возвращает список поддерживаемых форматов файлов глоссария.
500 Внутренняя ошибка сервера.
Другие коды состояния • Слишком много запросов
• Временный сервер недоступен

Получить ответ о поддерживаемых форматах глоссария

Базовый тип для возврата списка в API получения поддерживаемых форматов глоссария.

Успешный ответ на получение поддерживаемых форматов глоссария

Базовый тип для возврата списка в API получения поддерживаемых форматов глоссария.

Имя. Тип Описание
значение FileFormat [] FileFormat[] содержит перечисленные сведения.
value.contentTypes строка [] Поддерживаемые типы содержимого для данного формата.
value.defaultVersion строка Версия по умолчанию, если значение не указано.
value.fileExtensions строка [] Поддерживаемое расширение файла для данного формата.
value.format строка Название формата.
value.versions строка [] Поддерживаемая версия.

Отклик в случае ошибки

Имя. Тип Описание
кодом строка Перечисления, содержащие коды ошибок высокого уровня. Принятые значения:
• InternalServerError
• InvalidArgument
• InvalidRequest
• RequestRateTooHigh
• ResourceNotFound
• ServiceUnavailable
•Несанкционированный
сообщение строка Получает сообщение об ошибке высокого уровня.
внутренняя ошибка InnerTranslationError Новый формат внутренней ошибки, соответствующий рекомендациям ПО API инструментов Foundry. Это сообщение об ошибке содержит обязательные свойства ErrorCode, message и необязательные свойства, сведения (пара "значение ключа"), внутреннюю ошибку (ее можно вложить).
код внутренней ошибки строка Получает строку с ошибкой кода.
сообщениеВнутреннейОшибки строка Получает сообщение об ошибке высокого уровня.
innerError.target строка Получает источник ошибки. Например, это будет documents или document id , если был недопустимый документ.

Примеры

Пример успешного ответа

Следующий объект JSON является примером успешного ответа.

{
    "value": [
        {
            "format": "XLIFF",
            "fileExtensions": [
                ".xlf"
            ],
            "contentTypes": [
                "application/xliff+xml"
            ],
            "defaultVersion": "1.2",
            "versions": [
                "1.0",
                "1.1",
                "1.2"
            ]
        },
        {
            "format": "TSV",
            "fileExtensions": [
                ".tsv",
                ".tab"
            ],
            "contentTypes": [
                "text/tab-separated-values"
            ]
        },
        {
            "format": "CSV",
            "fileExtensions": [
                ".csv"
            ],
            "contentTypes": [
                "text/csv"
            ]
        }
    ]
}

Пример ответа с ошибкой

Следующий объект JSON является примером ответа с ошибкой. Схема для других кодов ошибок такая же.

Код состояния: 500

{
  "error": {
    "code": "InternalServerError",
    "message": "Internal Server Error",
    "innerError": {
      "code": "InternalServerError",
      "message": "Unexpected internal server error has occurred"
    }
  }
}

Следующие шаги

Ознакомьтесь с нашим кратким руководством, чтобы узнать больше об использовании перевода документов и клиентской библиотеки.

Начало работы с переводом документов

  • Last updated on