Microsoft Translator APIs 接入

用到了Microsoft Translator APIs 的文本翻译,需要接入,但是之前没有任何经验。于是就研究一下,然后记录下来,给自己做个记录吧!
首先是接入文档的地址:
http://docs.microsofttranslator.com/text-translate.html#!/default/post_TranslateArray
文档的上部分是准备部分:

Microsoft Translator APIs 接入_第1张图片
A2EB00F9-8F40-490A-BCA4-8484AD5ECA55.png

就是让你去订阅这个服务,然后会给你一个key,这个key是使用的这个服务的一个标示吧!看到这暂时不知道,接着看下面的文档。

BD1BBC59-EB09-4CD8-9AA6-748A77457DF0.png

这就说了怎么使用这个key,要用这个key去Microsoft 服务器请求这个token。
接下来就是获取token的地址:
http://docs.microsofttranslator.com/oauth-token.html
然后文档里写到这样:

Microsoft Translator APIs 接入_第2张图片
73605D5F-EBC3-4FDC-A810-D60A228C5E59.png

你需要去请求一个token,请求token的地址是:
https://api.cognitive.microsoft.com/sts/v1.0/issueToken
请求的时候你需要在post的请求的header部分加上
Ocp-Apim-Subscription-Key=
或者
在请求的body里加上
Subscription-Key=
这样就会获得结果的token,是base64-token

在这里可能有问题是:
你单独添加一个Ocp-Apim-Subscription-Key或者Subscription-Key,可能获取不到token,你在这可以将两个都加上。

在下面有个测试的例子:

Microsoft Translator APIs 接入_第3张图片
F03FB064-D04D-4F2E-8566-C96403115846.png

就是将key填入,然后就能获取到token了,这就是下一步调用Microsoft翻译的一个组最重要的部分,到了这里就已经离成功不远了。

获取完下一步需要的token之后,接下来回到最开始的那个文档,发现最下面有一些 API的接口:

Microsoft Translator APIs 接入_第4张图片
9A2F1E61-8723-4D8F-B215-A5E5B4E6BBFD.png

那我们就看一下最开始的这个GET方法的Translate的方法。
先看一下请求的参数:

Microsoft Translator APIs 接入_第5张图片
9102F619-A996-4BCE-A7BE-BB05CFE52750.png

将你获得的token ,拼接上 Bearer + “ ”+token ,将这个填写到aped这项,接下来就是text、from、to这几个字断,这就是请求部分。

接下来看结果部分:

Microsoft Translator APIs 接入_第6张图片
A5C2EFB8-174A-4728-B667-C6046A015A32.png

这样基本就完成了翻译的工作。

总结一下

整个过程:
1、完成注册和服务的获取
2、获取到key,之后通过key去Microsoft的获取token
3、通过token去Microsoft 服务器翻译
整个过程其实就是2次http请求,分步完成,最后就是将结果解析出来。

你可能感兴趣的:(Microsoft Translator APIs 接入)