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

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

URL-адрес запроса

Отправьте запрос GET на следующий адрес.

GET https://<NAME-OF-YOUR-RESOURCE>.cognitiveservices.azure.com/translator/text/batch/v1.0/glossaries/formats

Узнайте, как найти имя личного домена.

Важно!

  • Во всех запросах API к службе перевода документов необходимо указывать конечную точку личного домена.
  • Вы не можете использовать конечную точку, указанную на портале Azure на странице ресурса Ключи и конечная точка, и глобальную конечную точку перевода (api.cognitive.microsofttranslator.com) для создания HTTP-запросов к службе перевода документов.

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

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

Заголовки Описание
Ocp-Apim-Subscription-Key Обязательный заголовок запроса

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

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

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

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

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

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

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

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

Сообщение об ошибке

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

Примеры

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

Ниже приведен пример успешного ответа.

{
    "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"
            ]
        }
    ]
}

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

ниже приведен пример ответа об ошибке. Схема для других кодов ошибок такая же.

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

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

Дальнейшие действия

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