萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> ASP.NET 程式設計

ASP.NET 串接百度翻譯 API 完整實作 (含錯誤處理、JSON 反序列化)

百度翻譯開放平台提供 HTTP API,支援多語言互譯。本文示範 ASP.NET (WebForms/MVC 通用) 以 `HttpWebRequest` 呼叫 API、組裝請求參數、處理 JSON 回應、錯誤碼對照與重試邏輯,並封裝為可重用的服務類別。

前置準備

  1. 註冊 百度翻譯開放平台 開發者帳號,建立應用取得 **APP ID** 與 **密鑰**。
  2. 確認 API 端點:`https://fanyi-api.baidu.com/api/trans/vip/translate` (標準版) 或 `https://fanyi-api.baidu.com/api/trans/vip/fieldtranslate` (領域版)。
  3. 簽名算法:`sign = MD5(appid + q + salt + key)` (UTF-8 編碼,32 位小寫十六進制)。

資料傳輸物件 (DTO)

[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; }
}

WebForms 頁面呼叫範例

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, "百度翻譯呼叫失敗");
    }
}

MVC Controller 版本

[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 });
    }
}

進階:頻率限制與重試 (Polly)

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));

安全性與成本控制

  • **APP Key 嚴禁前端暴露**,務必在伺服端呼叫。
  • 設定 **IP 白名單** (百度後台配置) 限制呼叫來源。
  • 監控 **字符用量**,避免超額扣費 (標準版免費額度 200 萬字/月)。
  • 長文本建議 **分段翻譯** (單次 ≤ 6000 字節),並實作客戶端快取避免重複翻譯相同內容。

封裝為服務類別並配合 Polly 重試、快取、監控,即可穩健整合百度翻譯功能至 ASP.NET 應用。

copyright © 萬盛學電腦網 all rights reserved