有道翻譯開放 API 免費額度每小時 1000 次,適合中小型專案整合翻譯功能。本文示範 PHP 串接 JSON 介面的完整流程。
https://fanyi.youdao.com/openapi?path=data-mode 註冊應用,取得 keyfrom 與 key。GET https://fanyi.youdao.com/openapi.do
參數:
keyfrom=你的keyfrom
key=你的key
type=data
doctype=json|xml|jsonp
version=1.1
q=待翻譯文字(UTF-8,不超過 200 字元)
| errorCode | 含義 |
|---|---|
| 0 | 正常 |
| 20 | 文字過長 |
| 30 | 無法翻譯 |
| 40 | 不支援語言 |
| 50 | 無效 key |
<?php
function youdaoTranslate($content, $keyfrom, $key) {
$url = "https://fanyi.youdao.com/openapi.do?keyfrom={$keyfrom}&key={$key}&type=data&doctype=json&version=1.1&q=" . urlencode($content);
$response = file_get_contents($url);
if ($response === false) {
return ['error' => '網路請求失敗'];
}
$data = json_decode($response, true);
if (!isset($data['errorCode'])) {
return ['error' => 'API 回傳格式異常'];
}
if ($data['errorCode'] !== 0) {
return ['error' => '翻譯失敗,錯誤碼:' . $data['errorCode']];
}
// 正常回傳結構:translation(陣列)、basic(詞典)、web(網路釋義)
return $data;
}
// 使用
$keyfrom = 'your_keyfrom';
$key = 'your_key';
$result = youdaoTranslate('Hello world', $keyfrom, $key);
print_r($result);
cURL 替代 file_get_contents,可控制超時、重試、代理。trans:{md5(text)}),減少 API 呼叫與延遲。