检索文档翻译服务支持的文档格式列表。 在提交翻译作业之前，使用此终结点验证文件类型，并发现支持的 MIME 类型和特定于格式的版本控制。
HTTP 方法： GET API 版本： 2026-03-01
请求
GET {endpoint}/translator/document/formats?api-version=2026-03-01&type=document
| 标题 |
必需 |
Description |
Ocp-Apim-Subscription-Key |
是的 |
Azure门户中的翻译器资源密钥。 |
Ocp-Apim-Subscription-Region |
条件 |
如果使用区域资源，则为必需。 |
查询参数
| 参数 |
必需 |
Description |
api-version |
是的 |
API 的版本。 当前值： 2026-03-01. |
type |
No |
按格式类型筛选结果。 用于 document 检索文档格式。 省略以返回所有格式。 |
示例请求
curl -X GET "{endpoint}/translator/document/formats?api-version=2026-03-01&type=document" \
-H "Ocp-Apim-Subscription-Key: {key}"
响应
响应状态代码
| 状态代码 |
Description |
200 |
单击“确定”。 返回受支持的文档格式的列表。 |
401 |
身份验证失败。 检查订阅密钥。 |
500 |
内部服务器错误。 |
响应正文
| 领域 |
类型 |
Description |
value |
数组 |
FileFormat对象的数组。 |
value[].format |
字符串 |
格式名称（例如， DOCX）。 |
value[].fileExtensions |
数组 |
支持的文件扩展名列表（例如 .docx）。 |
value[].contentTypes |
数组 |
此格式的 MIME 类型列表。 |
value[].defaultVersion |
字符串 |
未指定时 storageInputFileFormat 使用的默认格式版本。 |
value[].versions |
数组 |
可用的格式版本。 |
相关内容