百度翻譯開放平台提供 HTTP API,支援多語言互譯。本文示範 ASP.NET (WebForms/MVC 通用) 以 `HttpWebRequest` 呼叫 API、組裝請求參數、處理 JSON 回應、錯誤碼對照與重試邏輯,並封裝為可重用的服務類別。
[DataContract]
public class BaiduTranslateResponse {
[DataMember(Name = "from")] public string From { get; set; }
[DataMember(Name = "to")] public string To { get; set; }
[DataMember(Name = "trans_result")] public List TransResult { get; set; }
[DataMember(Name = "error_code")] public string ErrorCode { get; set; }
[DataMember(Name = "error_msg")] public string ErrorMsg { get; set; }
}
[DataContract]
public class TransResult {
[DataMember(Name = "src")] public string Src { get; set; }
[DataMember(Name = "dst")] public string Dst { get; set; }
}
public class BaiduTranslateService {
private const string Endpoint = "https://fanyi-api.baidu.com/api/trans/vip/translate";
private readonly string _appId;
private readonly string _appKey;
public BaiduTranslateService(string appId, string appKey) {
_appId = appId;
_appKey = appKey;
}
public async Task TranslateAsync(string text, string from = "auto", string to = "zh") {
if (string.IsNullOrWhiteSpace(text)) return string.Empty;
string salt = DateTimeOffset.UtcNow.ToUnixTimeSeconds().ToString();
string sign = ComputeSign(text, salt);
var parameters = new Dictionary {
["q"] = text,
["from"] = from,
["to"] = to,
["appid"] = _appId,
["salt"] = salt,
["sign"] = sign
};
string queryString = string.Join("&", parameters.Select(kvp => $"{kvp.Key}={Uri.EscapeDataString(kvp.Value)}"));
string url = $"{Endpoint}?{queryString}";
using (var client = new HttpClient()) {
client.Timeout = TimeSpan.FromSeconds(10);
HttpResponseMessage resp = await client.GetAsync(url);
resp.EnsureSuccessStatusCode();
string json = await resp.Content.ReadAsStringAsync();
var result = JsonConvert.DeserializeObject(json);
if (!string.IsNullOrEmpty(result.ErrorCode))
throw new BaiduTranslateException(result.ErrorCode, result.ErrorMsg);
return string.Join("\n", result.TransResult.Select(r => r.Dst));
}
}
private string ComputeSign(string q, string salt) {
string raw = _appId + q + salt + _appKey;
using (var md5 = MD5.Create()) {
byte[] hash = md5.ComputeHash(Encoding.UTF8.GetBytes(raw));
return BitConverter.ToString(hash).Replace("-", "").ToLowerInvariant();
}
}
}
public class BaiduTranslateException : Exception {
public string ErrorCode { get; }
public BaiduTranslateException(string code, string msg) : base($"[{code}] {msg}") { ErrorCode = code; }
}
protected async void btnTranslate_Click(object sender, EventArgs e) {
lblResult.Text = "翻譯中...";
try {
var svc = new BaiduTranslateService(
ConfigurationManager.AppSettings["BaiduAppId"],
ConfigurationManager.AppSettings["BaiduAppKey"]);
string translated = await svc.TranslateAsync(txtSource.Text, ddlFrom.SelectedValue, ddlTo.SelectedValue);
txtResult.Text = translated;
lblResult.Text = "完成";
} catch (BaiduTranslateException ex) {
lblResult.Text = $"錯誤: {ex.Message}";
// 常見錯誤碼: 52001 請求超時, 52002 系統錯誤, 54000 必填參數缺失, 54001 簽名錯誤, 54003 訪問頻率受限, 58000 客戶端 IP 非法
} catch (Exception ex) {
lblResult.Text = "系統異常: " + ex.Message;
Log.Error(ex, "百度翻譯呼叫失敗");
}
}
[HttpPost]
public async Task Translate(string text, string from = "auto", string to = "zh") {
var svc = new BaiduTranslateService(_config["Baidu:AppId"], _config["Baidu:AppKey"]);
try {
string result = await svc.TranslateAsync(text, from, to);
return Json(new { success = true, text = result });
} catch (BaiduTranslateException ex) {
return Json(new { success = false, errorCode = ex.ErrorCode, message = ex.Message });
}
}
var policy = Policy
.Handle(ex => ex.ErrorCode == "54003") // 訪問頻率受限
.WaitAndRetryAsync(3, i => TimeSpan.FromSeconds(Math.Pow(2, i))); // 指數退避
string result = await policy.ExecuteAsync(() => svc.TranslateAsync(text, from, to));
封裝為服務類別並配合 Polly 重試、快取、監控,即可穩健整合百度翻譯功能至 ASP.NET 應用。