翻译器 3.0:字典示例
提供示例,说明如何在上下文中使用字典中的术语。 此操作与字典查找一起使用。
请求 URL
将 POST
请求发送到:
https://api.translator.azure.cn/dictionary/examples?api-version=3.0
请参阅虚拟网络支持,以了解翻译器服务选择的网络和专用终结点配置与支持。
请求参数
查询字符串上传递的请求参数如下:
查询参数 | 说明 |
---|---|
api-version | 必需参数。 客户端所请求的 API 的版本。 值必须是 3.0 。 |
from | 必需参数。 指定输入文本的语言。 源语言必须是 dictionary 范围中包含的支持的语言之一。 |
to | 必需参数。 指定输出文本的语言。 目标语言必须是 dictionary 范围中包含的支持的语言之一。 |
请求标头包括:
头文件 | 说明 |
---|---|
身份验证标头 | 必需的请求标头。 请参阅身份验证>用于身份验证的可用选项。 |
Content-Type | 必需的请求标头。 指定有效负载的内容类型。 可能的值为: application/json |
Content-Length | 可选。 请求正文的长度。 |
X-ClientTraceId | 可选。 客户端生成的 GUID,用于唯一标识请求。 如果在查询字符串中使用名为 ClientTraceId 的查询参数包括了跟踪 ID,则可以省略此标头。 |
请求正文
请求的正文是一个 JSON 数组。 每个数组元素都是一个具有以下属性的 JSON 对象:
Text
:用于指定要查找的术语的字符串。 此属性应该是前一个字典查找请求的反向翻译中normalizedText
字段的值。 它也可以是normalizedSource
字段的值。Translation
:一个字符串,指定字典查找操作先前返回的翻译文本。 此属性应该是字典查找响应的translations
列表中normalizedTarget
字段的值。 该服务返回特定源-目标字对的示例。
示例如下:
[
{"Text":"fly", "Translation":"volar"}
]
以下限制适用:
- 该数组最多可具有 10 个元素。
- 数组元素的文本值不能超过 100 个字符 (包括空格)。
响应正文
成功的响应是一个 JSON 数组,其中的每个结果对应于输入数组中的一个字符串。 结果对象包括以下属性:
normalizedSource
:一个字符串,提供源术语的规范化形式。 通常,此属性应该与请求正文中匹配列表索引处的Text
字段的值相同。normalizedTarget
:一个字符串,给出目标术语的规范化形式。 通常,此属性应该与请求正文中匹配列表索引处的Translation
字段的值相同。examples
:(源术语、目标术语)对的示例列表。 每个列表元素都是一个具有以下属性的对象:sourcePrefix
:在sourceTerm
的值之前连接以形成完整示例的字符串。 不要添加空格字符,因为它在应存在时已经存在了。 此值可为空字符串。sourceTerm
:一个字符串,等于被查找的实际术语。 该字符串添加了sourcePrefix
和sourceSuffix
以形成完整示例。 其值是分开的,因此可以在用户界面中标记,例如通过将其标为粗体。sourceSuffix
:在sourceTerm
的值之后连接以形成完整示例的字符串。 不要添加空格字符,因为它在应存在时已经存在了。 此值可为空字符串。targetPrefix
:一个类似于sourcePrefix
但用于目标的字符串。targetTerm
:一个类似于sourceTerm
但用于目标的字符串。targetSuffix
:一个类似于sourceSuffix
但用于目标的字符串。注意
如果字典中没有示例,则响应为“200 (正常)”,但
examples
列表为空列表。
示例
此示例演示如何查找由英语术语 fly
及其西班牙语翻译 volar
组成的配对的示例。
curl -X POST "https://api.translator.azure.cn/dictionary/examples?api-version=3.0&from=en&to=es" -H "Ocp-Apim-Subscription-Key: <client-secret>" -H "Ocp-Apim-Subscription-Region: your-region" -H "Content-Type: application/json" -d "[{'Text':'fly', 'Translation':'volar'}]"
响应正文是(为清楚起见已缩写):
[
{
"normalizedSource":"fly",
"normalizedTarget":"volar",
"examples":[
{
"sourcePrefix":"They need machines to ",
"sourceTerm":"fly",
"sourceSuffix":".",
"targetPrefix":"Necesitan máquinas para ",
"targetTerm":"volar",
"targetSuffix":"."
},
{
"sourcePrefix":"That should really ",
"sourceTerm":"fly",
"sourceSuffix":".",
"targetPrefix":"Eso realmente debe ",
"targetTerm":"volar",
"targetSuffix":"."
},
//
// ...list abbreviated for documentation clarity
//
]
}
]