快速开始

获取凭证

进入 Loxily 控制台，左侧菜单选择 开放平台，在顶部信息卡片中获取：

• App Key — 项目唯一标识符，用于标识请求来源（点击复制）
• App Secret — 用于请求签名，请妥善保管，不要泄露（默认遮掩，点击眼睛图标显示完整内容）

首次使用点击 "生成 App Secret" 按钮即可；如果泄露，可随时在同一卡片重新生成（原 Secret 立即失效）。

了解签名机制

所有开放平台 API 请求的鉴权都通过 HTTP Header 完成（X-Loxily-AppKey / X-Loxily-Timestamp / X-Loxily-Sign），请求体保持为纯业务 JSON。

详细的签名公式、示例和多语言代码实现参考 签名算法；请求公共 header、响应公共字段、错误码对照参考 公共参数。

推荐的集成路径

1. 先调 查询项目语言列表 —— 确认当前 AppKey 绑定项目支持哪些目标语言
2. 调 创建翻译任务 —— 拿到 task_id 和 trace_id
3. 监听回调 —— 任务在每个工作流节点完成后向你配置的 callback_url 推送事件（term_scan.completed → TRANSLATE 子步骤 → task.completed / task.failed / smart_optimize.completed）
4. 若创建时关闭了 auto_apply_terms —— 收到 term_scan.completed 后通过 查询 / 修改 / 删除 调整术语，再调 确认术语并继续翻译 进入正式翻译

开放平台页面的"平台调试"Tab 提供在线 API 调试工具，可以边调边对照；"调用日志"Tab 按 trace_id 反查每次请求的完整 Request / Response / Callback 时间线。