以下是如何使用Microsoft Translator API入门的说明。Google Translate API也可以实现相同的功能,但对我来说,由于Microsoft提供每月免费翻译200万个字符,而Google则最少收取1美元进行测试,因此使用MS更加容易。
先决条件:
1. 在
Microsoft Translator上注册免费订阅。您将被要求创建新的MS帐户或使用现有帐户登录。
2. 在
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: '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"
}
现在我们已经获得了访问令牌,是时候进行翻译请求了。注意:这些是JSONP请求,并且访问令牌是使用查询字符串参数
appId
提供的,格式为
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"]
官方文档已包含。