Media типы и подтипы (MIME-Types)
Указание media-типа используется для передачи сведений о формате содержимого в HTTP-транзакциях. Клиенты используют media-типы в своих заголовках Accept для того, чтобы сообщить, в каких форматах они предпочитают принимать данные. Серверы используют media-типы в заголовках Content-Type, чтобы сообщить клиенту о том, в каком формате передается прилагаемое содержимое: то ли это HTML, который нужно форматировать, то ли это GIF или JPEG, требующий визуализации, то ли это данные в формате PDP, для которого нужно открывать внешнюю программу просмотра или использовать дополнительное приложение.
Media-типы Internet, используемые в HTTP, очень напоминают типы MIME. MIME (Multipurpose Internet Mail Extension — многоцелевые расширения электронной почты для Internet) разработаны как метод передачи присоединенных данных по Internet средствами электронной почты. Как и MIME, media-тип указывается в формате тип/подтип. Символ * используется как метасимвол; например, следующий заголовок клиента означает, что принимаются документы во всех форматах:
Accept: */*
Следующий заголовок клиента означает, что принимаются все типы формата text независимо от подтипа:
Accept: text/*
Серверы и CGI-программы должны проверять данные о принимаемых типах, содержащиеся в заголовке Accept, и по возможности выдавать данные соответствующего типа. Большинство серверов определяют формат документа по суффиксу имени файла. Например, файлы с расширениями .htm и .html — это файлы в формате HTML, поэтому сервер посылает такой документ с типом text/html в заголовке Content-Type. При вызове CGI-программы серверу неизвестен формат возвращаемых данных, поэтому программа должна сообщить тип содержимого. По этой причине каждая CGI-программа должна включать в результат своей работы заголовок Content-Type, например:
Content-Type: text/html
В следующей таблице перечислены общепринятые media-типы, а также суффиксы имен файлов, распознаваемые большинством серверов. Большинство серверов можно легко настроить так, чтобы они распознавали и другие суффиксы.
| Тип/Подтип | Обычное расширение |
|---|---|
| application/activemessage | |
| application/andrew-inset | |
| application/applefile | |
| application/atomicrnail | |
| application/cals-l840 | |
| application/commonground | |
| application/cybercash | |
| application/dca-rft | |
| application/dec-dx | |
| application/eshop | |
| application/iges | |
| application/mac-binhex40 | |
| application/macwriteii | |
| application/mathematica | |
| application/msword | |
| application/news-message-id | |
| application/news-transmission | |
| application/octet-stream | bin |
| application/oda | oda |
| application/pdf | |
| application/postscript | ai, eps, ps |
| application/remote-printing | |
| application/riscos | |
| application/rtf | rtf |
| application/sgml | |
| application/slate | |
| application/vnd.framemaker | |
| application/vnd.koan | |
| application/vnd.mif | |
| application/vnd.ms-artgalry | |
| application/vnd.ms-excel | |
| application/vnd.ms-powerpoint | |
| application/vnd.ms-project | |
| application/vnd.ms-tnef | |
| application/vnd.ms-works | |
| application/vnd.music-niff | |
| application/vnd.svd | |
| application/vnd.truedoc | |
| application/wita | |
| application/wordperfect5.1 | |
| application/x-bcpio | bcpio |
| application/x-cpio | cpio |
| application/x-csh | csh |
| application/x-dvi | dvi |
| application/x-gtar | gtar |
| application/x-hdf | hdf |
| application/x-latex | latex |
| applicatlon/x-mif | mif |
| application/x-netcdf | nc, cdf |
| application/x-sh | sh |
| application/x-shar | shar |
| application/x-sv4cpio | sv4cpio |
| application/x-sv4crc | sv4crc |
| application/x-tar | tar |
| application/x-tcl | tcl |
| application/x-tex | tex |
| application/x-texinfo | texinfo, texi |
| application/x-troff-man | man |
| application/x-troff-me | me |
| application/x-troff-ms | ms |
| applicatlon/x-troff | t, tr, roff |
| application/x-ustar | ustar |
| application/x-wais-source | src |
| application/x400-bp | |
| application/zip | zip |
| application/32kadpcm | |
| application/basic | au, snd |
| application/x-aiff | aif, aiff, aifc |
| application/x-wav | wav |
| image/cgm | |
| image/g3fax | |
| image/gif | gif |
| image/ief | ief |
| image/jpeg | jpeg, jpg, jpe |
| image/naplps | |
| image/tiff | tiff, tif |
| image/vnd.dwg | |
| image/vnd.dxf | |
| image/vnd.svf | |
| image/x-cmu-raster | ras |
| image/x-portable-anymap | rpnm |
| image/x-portable-bitmap | pbm |
| image/x-portable-graymap | pgm |
| image/x-portable-pixmap | ppm |
| image/x-rgb | rgb |
| image/x-xbitmap | xbm |
| imaqe/x-xpixrnap | xpm |
| image/x-xwindowdump | xwd |
| message/external-body | |
| message/http | |
| message/news | |
| message/partial | |
| messacie/rfc822 | |
| multipart/alternative | |
| multipart/appledouble | |
| multipart/digest | |
| multipart/form-data | |
| multipart/header-set | |
| multipart/mixed | |
| multipart/parallel | |
| multipart/related | |
| multipart/report | |
| multipart/voice-message | |
| text/enriched | |
| text/html | html, htm |
| text/plain | txt |
| text/richtext | rtx |
| text/sgml | |
| text/tab-separated-values | tsv |
| text/x-setext | etx |
| video/mpeg | mpeg, mpg, mpe |
| video/quicktime | qt, mov |
| video/vnd.vivo | |
| video/x-msvideo | qvi |
| video/x-sgi-movie | movie |
Отсутствует панель сообщений сервера для документов Office, открытых по гиперссылке
Пользователи Office 2007 или Office 2010 в любой клиентской операционной системе щелкают гиперссылку, которая указывает на документ Office, расположенный в библиотеке документов SharePoint Server 2010. Сама гиперссылка находится в сообщении электронной почты Outlook. Вместо открытия документа с сервера в клиентском приложении Office документ открывается в приложении Office из кэша временных файлов Интернета на локальном компьютере. Поэтому он не рассматривается как серверный документ. Пользователь может увидеть следующие симптомы:
- Word: нет серверной панели с кнопкой «Изменить документ»
- Excel: нет панели сервера с кнопкой «Изменить книгу»
- PowerPoint: нет панели сервера с кнопкой «Изменить презентацию»
Или, если библиотеке документов требуется извлечение:
- Word: нет панели сервера с кнопкой «Извлечение документа»
- Excel: нет панели сервера с кнопкой «Извлечение книги»
- PowerPoint: нет панели сервера с кнопкой «Извлечение презентации»
Кроме того, документ не может быть сохранен обратно на сайт SharePoint, пока он открыт в приложении Office. Пользователи могут сохранять изменения, но они сохраняются в файле папки «Временные файлы Интернета», а не на сервере SharePoint.
Кроме того, если документ является частью рабочего процесса, кнопка «Изменить задачу» или «Открыть эту задачу» и другие кнопки, связанные с рабочим процессом, будут отсутствовать, в результате чего рабочий процесс не будет запущен. Обычно пользователи получают задачи рабочего процесса по электронной почте, а сообщение электронной почты будет содержать гиперссылку на документ, расположенный на сервере SharePoint.
Это происходит только в новых форматах файлов Office: .docx, .pptx и .xlsx. Это не происходит в старых устаревших форматах файлов Office: .doc, .ppt и .xls. Кроме того, это происходит только в следующих случаях:
Сервер является сервером SharePoint Server 2010 и
- Если клиентский компьютер работает под управлением Office 2007, проблема возникает с документами .docx, DOTX, .xlsx и .pptx.
или - Когда клиентский компьютер работает под управлением Office 2010, проблема возникает с .pptx документов.
Эта проблема не возникает, если на сервере работает Office SharePoint Server 2007, а на клиентском компьютере — Office 2007 или Office 2010.
ПРИМЕЧАНИЕ. Это происходит только при открытии документа Office, щелкнув ГИПЕРССЫЛКУ в сообщении Электронной почты Outlook, и документ Office находится в библиотеке документов SharePoint 2010. Если пользователь перейдите в библиотеку документов SharePoint 2010 и откроет файл, эта проблема не возникает.
Причина
SharePoint 2010 реализует новую функцию безопасности с именем «Разрешительный или строгий режим обработки файлов браузера». Каждый тип файла, доставленного с веб-сервера, имеет связанный тип MIME (также называемый «типом контента»), который описывает характер содержимого (например, изображение, текст, приложение и т. д.). Internet Explorer (IE) имеет функцию проверки MIME, которая будет пытаться определить тип контента для каждого скачанного ресурса. Для файлов Office, если тип контента, отправленный сервером, не найден в базе данных MIME в реестре клиентского компьютера, IE «сканирует» типы контента MIME, чтобы узнать, существует ли другой похожий тип MIME в базе данных MIME клиентского компьютера, и откроет файл с помощью аналогичного типа MIME. Однако по умолчанию в каждом веб-приложении в SharePoint 2010 включена строгая обработка файлов браузера, что запрещает сканирование типов контента, поэтому если точное соответствие типа контента, отправленного в ответе сервера, не найдено в базе данных MIME клиента в реестре, файл откроется из временных файлов Интернета клиентского компьютера, а не с сервера. Сканирование MIME также может привести к проблемам безопасности для серверов, на которых размещено недоверенное содержимое.
Например, при открытии файла .docx из гиперссылки, указывающей на документ, расположенный в библиотеке документов SharePoint 2010, тип контента, отправленный сервером SharePoint 2010 в ответе, выглядит следующим образом: «vnd.ms-word.document.12» с заголовком «X-Content-Type-Options: nosniff»:
HTTP/1.1 200 OK Content-Length: 108 Date: Day, [Date and Time] GMT Content-Type: vnd.ms-word.document.12 X-Content-Type-Options: nosniff Так как этот тип контента отсутствует в области MIME в реестре клиентского компьютера Office и сканирование MIME не выполняется, документ открывается из временных файлов Интернета.
Возможны и другие причины, упомянутые ниже в разделе «Дополнительные сведения».
Решение
Используйте одно из следующих решений:
Обходной путь на стороне сервера
Устранение заголовка без проверки, отправленного из SharePoint 2010
- Перейдите на сайт центра администрирования и щелкните «Управление веб-приложениями» в разделе «Управление приложениями».
- Выберите веб-приложение и нажмите кнопку «Параметры» на ленте
- Прокрутите вниз до области «Обработка файлов браузера» и выберите «Разрешительный», а не «Строгий».
ПРИМЕЧАНИЕ. Это снижает безопасность. Обработка файлов браузера указывает, добавляются ли дополнительные заголовки безопасности в документы, обслуживаемые веб-браузерами. Эти заголовки указывают, что браузер должен отображать запрос на скачивание определенных типов файлов (например, .html) и использовать указанный тип MIME сервера для других типов файлов. «Нестрогий» указывает, что заголовки не добавляются, что обеспечивает более совместимое взаимодействие с пользователем. «Строгий» добавляет заголовки, которые принудительно загружают определенные типы файлов в браузере. Принудительная загрузка повышает безопасность сервера, запрещая автоматическое выполнение веб-содержимого, отправляемого участниками.
Обходные пути на стороне клиента
В этот раздел, описание метода или задачи включены действия, содержащие указания по изменению параметров реестра. Однако неправильное изменение параметров реестра может привести к возникновению серьезных проблем. Поэтому следует в точности выполнять приведенные инструкции. Для дополнительной защиты создайте резервную копию реестра, прежде чем редактировать его. Так вы сможете восстановить реестр, если возникнет проблема. Дополнительные сведения о создании резервной копии и восстановлении реестра см. в соответствующей статье базы знаний Майкрософт:
322756 как создать резервную копию и восстановить реестр в Windows.
Обновите реестр клиентского компьютера Office, чтобы установить необходимые типы контента в базу данных MIME реестра с помощью одного из следующих двух методов. Это обновление реестра работает в Office 2007 или Office 2010.
-
Чтобы обновить реестр вручную, скопируйте следующий код в текстовый файл, приведите для него имя с расширением REG и запустите его.
Windows Registry Editor Version 5.00 [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-excel.12] "Extension"=".xlsx" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-powerpoint.presentation.12] "Extension"=".pptx" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-word.document.12] "Extension"=".docx" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-word.template.12] "Extension"=".dotx" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-powerpoint.template.12] "Extension"=".potx" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-powerpoint.show.macroEnabled.12] "Extension"=".ppsm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-powerpoint.show.12] "Extension"=".ppsx" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-powerpoint.macroEnabled.12] "Extension"=".pptm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/x-mspublisher] "Extension"=".pub" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-excel.binary.12] "Extension"=".xlsb" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-excel.macroEnabled.12] "Extension"=".xlsm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-excel.macroEnabledTemplate.12] "Extension"=".xltm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-excel.template.12] "Extension"=".xltx" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-word.document.macroEnabled.12] "Extension"=".docm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-word.template.macroEnabled.12] "Extension"=".dotm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-powerpoint.template.macroEnabled.12] "Extension"=".potm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-powerpoint.presentation.macroEnabled.12] "Extension"=".pptm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-excel.sheet.macroEnabled.12] "Extension"=".xlsm" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/vnd.ms-excel.addin.12] "Extension"=".xlam" [HKEY_CLASSES_ROOT\MIME\Database\Content Type\application/onenote] "Extension"=".one" Дополнительная информация
Кнопки задач рабочего процесса SharePoint могут отсутствовать в документах Office по другим причинам, чем описано в этой статье. Некоторые другие причины могут быть следующими:
- Панель сообщений отключена в параметрах центра управления безопасностью.
- Вы используете низкоприоритетную лицензию Office (домашняя и бизнес-, домашняя и учащаяся) или другой продукт из розничного канала. См . все о рабочих процессах утверждения.
- Рабочий процесс для открытого документа еще не запущен.
- У пользователя нет разрешений на изменение элементов. Кроме того, им могут потребоваться разрешения на управление списками в зависимости от параметров рабочего процесса.
- При первом нажатии гиперссылки на документ Office 2010, который впервые хранится на сайте SharePoint, может отсутствовать панель только для чтения сервера с кнопкой [Изменить документ] или [Изменить книгу] или [Изменить презентацию] или [Изменить презентацию]. Последующие щелчки по ссылке будут отображать панель только для чтения сервера.
Чтобы панель сервера только для чтения отображала при первом щелчке гиперссылки, добавьте приведенный ниже раздел реестра на клиентский компьютер.
Key: HKEY_CURRENT_USER\Software\Microsoft\Office\14.0\Common\Internet Name: OptimisticBHO Type: DWORD Value: 1 Если панель сервера по-прежнему не отображается с кнопкой [Изменить документ] даже после включения ключа OptimisticBHO, убедитесь, что надстройка «Обработчик кэша документов Office» включена в надстройки управления средствами Internet Explorer>.
Требуется дополнительная помощь? Посетите сайт сообщества SharePoint.
Разрешенные типы вложений для отправки электронной почты в Службы коммуникации Azure email
Операция отправки электронной почты позволяет отправителю добавлять вложения в исходящее сообщение электронной почты. Наряду с самим содержимым отправитель должен включать тип вложения файла с помощью стандарта MIME при выполнении запроса с вложением. Многие распространенные типы файлов принимаются, например документы Word, электронные таблицы Excel, множество форматов изображений и видео, контактов и приглашений календаря.
Что такое тип MIME?
Типы MIME (многоцелевых расширений электронной почты) — это способ идентификации типа данных, отправляемых через Интернет. Когда пользователи отправляют запросы электронной почты с помощью Службы коммуникации Azure email, они могут указать тип MIME содержимого электронной почты, что позволяет клиенту электронной почты получателя правильно отображать и интерпретировать сообщение. Если сообщение электронной почты содержит вложение, тип MIME будет иметь соответствующий тип файла (например, application/pdf) для PDF-документа.
Разработчики могут убедиться, что клиент электронной почты получателя правильно форматирует и интерпретирует сообщение электронной почты с помощью типов MIME, независимо от используемого программного обеспечения или платформы. Эта информация помогает убедиться, что сообщение электронной почты доставлено правильно, и получатель может получить доступ к содержимому по мере необходимости. Кроме того, использование типов MIME также может помочь повысить безопасность сообщений электронной почты, так как они могут использоваться для указания того, включает ли сообщение исполняемое содержимое или другие потенциально опасные элементы.
В итоге типы MIME являются критически важным компонентом обмена сообщениями электронной почты, и с помощью них с Службы коммуникации Azure Email разработчики могут помочь гарантировать, что их сообщения электронной почты доставлены правильно и безопасно.
Разрешенные типы вложений
Ниже приведен список некоторых наиболее распространенных поддерживаемых расширений файлов и соответствующих типов MIME для вложений электронной почты с помощью Службы коммуникации Azure Email:
| Расширение файла | Description | Тип MIME |
|---|---|---|
| .3gp | Мультимедийный файл 3GPP | video/3gpp |
| .3g2 | Мультимедийный файл 3GPP2 | video/3gpp2 |
| .7z | Сжатый 7-ZIP-файл | application/x-7z-compressed |
| .Aac | Звук AAC | audio/aac |
| .Avi | Видеофайл AVI | video/x-msvideo |
| BMP | Изображение BMP | image/bmp |
| .csv | Значения, разделенные запятыми | text/csv |
| .doc | Документ Microsoft Word (97-2003) | application/msword |
| .docm | Документ с поддержкой макросов Microsoft Word | application/vnd.ms-word.document.macroEnabled.12 |
| DOCX | Документ Microsoft Word (2007 или более поздней версии) | application/vnd.openxmlformats-officedocument.wordprocessingml.document |
| .Eot | Встроенный шрифт OpenType | application/vnd.ms-fontobject |
| .Epub | Ebook EPUB | application/epub+zip |
| .gif | ИЗОБРАЖЕНИЕ GIF | image/gif |
| .gz | Сжатый файл Gzip | application/gzip |
| ICO | Файл значка | image/vnd.microsoft.icon |
| .ics | ICalendar-файл | text/calendar |
| .jpg, .jpeg | Изображение JPEG | image/jpeg |
| json. | Данные JSON | application/json |
| .mid, .midi | Звуковой файл MIDI | audio/midi |
| .mp3 | Аудиофайл MP3 | audio/mpeg |
| MP4 | Видеофайл MP4 | video/mp4 |
| .Mpeg | Видеофайл MPEG | video/mpeg |
| .Oga | Звуковой файл Ogg | audio/ogg |
| .Ogv | Видеофайл Ogg | video/ogg |
| .Ogx | Ogg-файл | application/ogg |
| указанным. | Файл Microsoft OneNote | application/onenote |
| .Opus | Звуковой файл Opus | audio/opus |
| .Otf | Шрифт OpenType | font/otf |
| PDF-документ | application/pdf | |
| PNG | Изображение PNG | image/png |
| PPSM | Слайд-шоу PowerPoint (с поддержкой макросов) | application/vnd.ms-powerpoint.slideshow.macroEnabled.12 |
| PPSX | Слайд-шоу PowerPoint | application/vnd.openxmlformats-officedocument.presentationml.slideshow |
| .ppt | Презентация PowerPoint (97-2003) | application/vnd.ms-powerpoint |
| .pptm | Презентация с поддержкой макросов PowerPoint | application/vnd.ms-powerpoint.presentation.macroEnabled.12 |
| PPTX | Презентация PowerPoint (2007 или более поздняя версия) | application/vnd.openxmlformats-officedocument.presentationml.presentation |
| .pub | Документ Microsoft Publisher | application/vnd.ms-publisher |
| .rar | Сжатый файл RAR | application/x-rar-compressed |
| .rpmsg | Сообщение электронной почты Outlook | application/vnd.ms-outlook |
| .rtf | Документ форматированного текста | application/rtf |
| .svg | Масштабируемое изображение векторной графики | image/svg+xml |
| .Смолы | Файл архива tar | application/x-tar |
| TIF, TIFF | Формат TIFF | image/tiff |
| .Ttf | Шрифт TrueType | font/ttf |
| .txt | Текстовый документ | text/plain |
| .vsd | Рисование Microsoft Visio | application/vnd.visio |
| .Wav | Формат аудиофайла волны | audio/wav |
| .Weba | Аудиофайл WebM | audio/webm |
| .Webm | Видеофайл WebM | video/webm |
| .webp | Файл образа WebP | image/webp |
| .wma | Звуковой файл Windows Media | audio/x-ms-wma |
| .wmv | Видеофайл Windows Media | video/x-ms-wmv |
| .woff | Формат открытого веб-шрифта | font/woff |
| .woff2 | Формат веб-шрифта 2.0 | font/woff2 |
| XLS. | Электронная таблица Microsoft Excel (97-2003) | application/vnd.ms-excel |
| .xlsb | Электронная таблица Microsoft Excel | application/vnd.ms-excel.sheet.binary.macroEnabled.12 |
| .xlsm | Электронная таблица с поддержкой макросов Microsoft Excel | application/vnd.ms-excel.sheet.macroEnabled.12 |
| XLSX | Электронная таблица Microsoft Excel (OpenXML) | application/vnd.openxmlformats-officedocument.spreadsheetml.sheet |
| XML | Расширяемый файл языка разметки | application/xml , text/xml |
| .zip | ZIP-архив | application/zip |
Существует множество других расширений файлов и типов MIME, которые можно использовать для вложений электронной почты. Однако этот список включает в себя принятые типы для отправки вложений в операции SendMail. Кроме того, разные клиенты и серверы электронной почты могут иметь различные ограничения или ограничения на размер и типы файлов, которые могут привести к сбою доставки электронной почты. Убедитесь, что получатель может принять вложение электронной почты или обратиться к документации для поставщиков электронной почты получателя.
Дополнительные сведения
Центр назначения номеров Интернета (IANA) является отделом Интернет-корпорации по назначенным именам и номерам (ICANN), отвечающим за глобальную координацию различных интернет-протоколов и ресурсов, включая управление и регистрацию типов MIME.
IANA поддерживает реестр стандартных типов MIME, который включает уникальный идентификатор для каждого типа MIME, краткое описание его назначения и связанные расширения файлов. Для получения наиболее актуальной информации о типах MIME, включая окончательный список типов мультимедиа, рекомендуется напрямую посетить веб-сайт IANA.
Следующие шаги
- Что такое Служба коммуникации электронной почты в составе службы коммуникации
- Домены электронной почты и проверка подлинности отправителя для Служб коммуникации Azure
- Начало работы с отправкой электронной почты с помощью службы коммуникации электронной почты в Службе коммуникации Azure
- Начало работы путем подключения службы коммуникации электронной почты к ресурсу Службы коммуникации Azure
Вас могут заинтересовать следующие документы:
- Сведения о клиентской библиотеке для электронной почты
- Как отправлять сообщения электронной почты с настраиваемыми проверенными доменами? Добавление пользовательских доменов
- Как отправлять сообщения электронной почты с помощью управляемых доменов Azure? Добавление управляемых доменов Azure
Получение сведений о поддерживаемых форматах документов
Метод получения поддерживаемых форматы документов возвращает список форматов документов, поддерживаемых службой перевода документов. Список включает общее расширение файла и тип содержимого при использовании API загрузки.
URL-адрес запроса
Отправьте запрос GET на следующий адрес.
GET https://.cognitiveservices.azure.com/translator/text/batch/v1.1/documents/formats - Во всех запросах API к службе перевода документов необходимо указывать конечную точку личного домена.
- Вы не можете использовать конечную точку, указанную на портале Azure на странице ресурса Ключи и конечная точка, и глобальную конечную точку перевода ( api.cognitive.microsofttranslator.com ) для создания HTTP-запросов к службе перевода документов.
Заголовки запросов
| Заголовки | Описание |
|---|---|
| Ocp-Apim-Subscription-Key | Обязательный заголовок запроса |
Коды состояния ответа
Ниже приведены возможные коды состояния HTTP, которые возвращает запрос.
- Слишком много запросов
- Сервер временно недоступен
Ответ формата файла
Успешный ответ fileFormatListResult
В случае успешного ответа возвращается следующая информация.
| Имя | Тип | Описание |
|---|---|---|
| value | FileFormat [] | FileFormat[] содержит перечисленные сведения. |
| value.contentTypes | string[] | Поддерживаемые типы содержимого для данного формата. |
| value.defaultVersion | строка | Версия по умолчанию, если значение не указано. |
| value.fileExtensions | string[] | Поддерживаемое расширение файла для данного формата. |
| value.format | строка | Название формата. |
| value.versions | строка [] | Поддерживаемая версия. |
Сообщение об ошибке
- InternalServerError
- InvalidArgument
- InvalidRequest
- RequestRateTooHigh
- ResourceNotFound
- ServiceUnavailable
- Не авторизовано
Примеры
Пример успешного ответа
Следующий объект JSON является примером успешного ответа.
Код состояния: 200.
Пример ответа с ошибкой
Ниже приведен пример объекта JSON для ответа с ошибкой. Схема для других кодов ошибок такая же.
Код состояния: 500
Дальнейшие действия
Чтобы узнать больше об использовании службы перевода документов и клиентской библиотеки, обратитесь к нашему краткому руководству.