下面我将解释如何开始使用 Microsoft Translator API。可以通过 Google Translate API 实现相同的功能,但是对于我来说,使用 MS 更容易,因为它们每月免费提供 200 万个字符的翻译,而 Google 收取最低 1 美元的测试费用。
先决条件:
在Microsoft Translator上注册免费订阅。为此,您将被要求创建新的 MS 帐户或使用现有帐户登录。
在Azure Datamarket上注册您的应用程序。
注册示例。注意:此处有两个重要字段客户端 ID和客户端密码,您将需要它们来请求访问令牌。

执行:
首先,对 API 的每个请求都应该包含访问令牌。到期时间为 10 分钟,因此您必须在到期前对其进行更新。理想情况下,该过程应在后端完成,以保护您的客户端机密并将结果(令牌 + 到期时间)发送回 Web 应用程序。
Node.js 示例:
var request = require("request");
var options = {
method: 'POST',
url: 'https://datamarket.accesscontrol.windows.net/v2/OAuth2-13/',
form: {
// Client ID & Client secret values (see screenshot)
client_id: 'translator_3000',
client_secret: 'ZP8LzjZkKuFAb2qa05+3nNq+uOcqzWK7e3J6qCN1mtg=',
scope: 'http://api.microsofttranslator.com',
grant_type: 'client_credentials'
}
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
响应包含几个字段,包括access_token,将其值用于进一步的请求。
{
"token_type": "http://schemas.xmlsoap.org/ws/2009/11/swt-token-profile-1.0",
"access_token": "http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=translator_3000&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fdatamarket.accesscontrol.windows.net%2f&Audience=http%3a%2f%2fapi.microsofttranslator.com&ExpiresOn=1435405881&Issuer=https%3a%2f%2fdatamarket.accesscontrol.windows.net%2f&HMACSHA256=st9LJ0F8CKSa6Ls59gQN0EqMWLFed5ftkJiOCVXE4ns%3d",
"expires_in": "600",
"scope": "http://api.microsofttranslator.com"
}
现在,当我们拥有访问令牌时,就该进行翻译请求了。appId
注意:这些是 JSONP 请求,访问令牌是使用格式中的查询字符串参数提供的Bearer <token>
(以空格分隔)。查询字符串还包括text
参数 - 您的帖子的文本和to
参数 - 用户选择的语言代码、所有支持代码的列表以及您也可以从 API 获得的语言友好名称。
这是示例:
var settings = {
"url": "https://api.microsofttranslator.com/v2/Ajax.svc/Translate",
"method": "GET",
"dataType": "jsonp",
"jsonp" : "oncomplete",
"data" : {
"text" : "Good Morning StackOverflow",
"to" : "uk",
"appId" : "Bearer http%3a%2f%2fschemas.xmlsoap.org%2fws%2f2005%2f05%2fidentity%2fclaims%2fnameidentifier=translator_3000&http%3a%2f%2fschemas.microsoft.com%2faccesscontrolservice%2f2010%2f07%2fclaims%2fidentityprovider=https%3a%2f%2fdatamarket.accesscontrol.windows.net%2f&Audience=http%3a%2f%2fapi.microsofttranslator.com&ExpiresOn=1435405881&Issuer=https%3a%2f%2fdatamarket.accesscontrol.windows.net%2f&HMACSHA256=st9LJ0F8CKSa6Ls59gQN0EqMWLFed5ftkJiOCVXE4ns%3d"
}
}
$.ajax(settings).done(function (response) {
console.log(response);
});
响应是翻译后的字符串,将替换为发布的原始文本:
"Доброго ранку StackOverflow"
最后,所有语言代码:
http://api.microsofttranslator.com/V2/Ajax.svc/GetLanguagesForTranslate
和选定代码的友好名称:
http://api.microsofttranslator.com/V2/Ajax.svc/GetLanguageNames?locale=en&languageCodes=["en", "de", "es", "uk"]
包括官方文档。