替换Google Translate API为Systran API后功能失效，求排查问题

以下是导致功能异常的核心问题及修正方向：

1. API端点错误 #

你代码中使用的https://api.example.com/translation是占位域名，必须替换为Systran官方提供的真实API端点（比如https://api.systran.net/translation/v2/translate这类符合文档规范的地址）。

2. 请求参数不匹配 #

• 参数命名：需严格对齐Systran文档要求，比如输入文本的参数名可能是text而非你写的input；语言参数的命名也要确认是否为source/target。
• 语言代码格式：谷歌API的语言代码（如zh-CN）和Systran的可能存在差异，需核对文档中的语言代码规范，避免因代码格式错误导致识别失败。
• 必填参数遗漏：部分Systran API版本可能要求额外参数（如format），需确认文档中的必填项是否全部包含。

3. 认证方式错误 #

你使用的Authorization: Key ${apiKey}可能不符合Systran的认证规范，部分版本的API要求使用X-Systran-Api-Key自定义头，或Bearer类型的认证格式，必须严格按照文档设置。

4. 响应解析逻辑错误 #

Systran的响应结构和谷歌API完全不同，你直接取json.translation必然失效。先查看控制台打印的json完整结构，确认翻译结果的实际嵌套路径（比如可能是json.outputs[0].output），再调整解析代码。

另外，建议在响应处理中增加HTTP状态校验：

.then(response => {
  if (!response.ok) throw new Error(`请求失败：${response.status}`);
  return response.json();
})

这样能快速捕获401（密钥错误）、404（端点错误）等HTTP层面的问题。

5. 其他潜在问题 #

• 确认API密钥有效且拥有翻译接口的调用权限，未超出额度或被封禁。
• 前端调用需检查CORS设置：若浏览器报跨域错误，需通过后端代理转发请求，或确认Systran API已允许你的域名跨域访问。

修正后的参考代码 #

function translate() {
  const inputText = inputTextElem.value;
  const inputLanguage = inputLanguageDropdown.querySelector(".selected").dataset.value;
  const outputLanguage = outputLanguageDropdown.querySelector(".selected").dataset.value;
  const apiKey = "YOUR_API_KEY";
  // 替换为Systran真实API端点
  const url = `https://api.systran.net/translation/v2/translate?source=${inputLanguage}&target=${outputLanguage}&text=${encodeURIComponent(inputText)}`;
  const headers = {
    // 以文档要求的认证头为准，此处为示例
    "X-Systran-Api-Key": apiKey
  };

  fetch(url, {
    method: "GET",
    headers: headers
  })
  .then(response => {
    if (!response.ok) throw new Error(`HTTP错误：${response.status}`);
    return response.json();
  })
  .then(json => {
    console.log(json);
    // 根据实际响应结构调整结果路径
    outputTextElem.value = json.outputs?.[0]?.output || "翻译失败";
  })
  .catch(error => {
    console.error("翻译错误:", error);
    outputTextElem.value = "翻译出错，请检查配置";
  });
}

内容的提问来源于stack exchange，提问作者user221117