使用微軟翻譯 API (Translator API - Microsoft Translator)

有個工作拖了很久，最後請同事協助處理了一下，順手筆記 :) 由於 App 撒出去世界各地，所以總會有好心人士留留言給予鼓勵，無奈很多語言都看不懂 XD 人工用 Google 翻譯當然夠用，但量大的時候，就希望能夠自動翻譯一下。

同事研究後，發現微軟翻譯 API 有免費使用額度（一個月200萬個字），所以就挑這來做了！

首先，註冊一下帳號：https://datamarket.azure.com/account ，填一下基本資料即可，一開始就會得到一組主要帳戶金鑰跟客戶識別碼，這組可以用來測試一些 API。

當要正式使用時，請至開發人員頁面，註冊一個應用程式(重導網址隨便輸入即可，在此不會用到)，用新註冊到的金鑰跟客戶識別碼來工作即可。不然會收到類似的訊息：

TranslateApiExceptionMethod: Translate()Message: Cannot find an active Azure Market Place Translator Subscription associated with the request credentials.message

整個微軟翻譯 API 的使用流程：

Step 1: 透過 client_id 和 client_secret 換得 token

<?php

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://datamarket.accesscontrol.windows.net/v2/OAuth2-13/');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query(array(
'grant_type' => 'client_credentials',
'scope' => 'http://api.microsofttranslator.com'
'client_id' => 'YourAppID',
'client_secret' => 'YourAppSecretKey'
)));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$ret = curl_exec($ch);
curl_close($ch);
$token = json_decode($ret)->access_token;

Step 2: 帶著 token 跟待查的資料去問微軟翻譯 API

<?php

// https://msdn.microsoft.com/en-us/library/ff512421.aspx
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://api.microsofttranslator.com/v2/Http.svc/Translate?'.http_build_query(array(
'text' => '第二十四個夏天後',
'from' => null,
'to' => 'en',
)));
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
'Authorization: Bearer '.$token,
));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$ret = curl_exec($ch);
curl_close($ch);
echo strip_tags($ret)."\n";

收工。