API 与 Agent 集成

Aha Translator 开发者资源

基于公开契约集成，不要猜测接口。

这些机器可读资源说明哪些能力公开可用、哪些需要用户令牌，以及 Agent 应在什么场景使用 Aha Translator。

OpenAPI 3.1

公开与需认证的操作、数据结构和安全要求。

/openapi.jsonAha Translator

OAuth 2.1 元数据

基于现有 Aha 用户身份系统、使用 PKCE 的授权码流程发现入口。

/.well-known/oauth-authorization-serverAha Translator

Agent 使用说明

最佳使用场景、产品边界、规范页面与恢复入口。

/llms.txtAha Translator

站点地图

所有营销语言下的规范公开页面。

身份认证

公开版本和价格元数据无需认证。用户数据与学习操作需要 bearer JWT。OAuth 客户端使用带 PKCE 的授权码流程；生产客户端需要审核登记，以保护用户数据与额度。

如需集成权限、OAuth 客户端登记或报告安全问题，请联系 support@ahatranslator.com。

错误响应

失败的 JSON 接口返回 `{ code, message, hint }`。请按 `code` 分支（例如 UNAUTHORIZED、INVALID_REQUEST、FEATURE_LIMIT_REACHED）。`message` 留给旧客户端；`hint` 告诉 Agent 如何恢复。产品 UI 不要直接展示 `message`。