Recursos para desenvolvedores do Aha Translator
Integre usando contratos documentados, não endpoints adivinhados.
Estes recursos legíveis por máquina explicam o que é público, o que exige token do usuário e quando um agente deve usar o Aha Translator.
OpenAPI 3.1
Operações públicas e autenticadas, esquemas e requisitos de segurança.
/openapi.jsonAha TranslatorMetadados OAuth 2.1
Descoberta do fluxo de autorização com PKCE usando a identidade Aha existente.
/.well-known/oauth-authorization-serverAha TranslatorInstruções para agentes
Casos de uso ideais, limites do produto e páginas canônicas.
/llms.txtAha TranslatorSitemap
Páginas públicas canônicas em todos os idiomas disponíveis.
/sitemap.xmlAutenticação
Versão e preços públicos não exigem autenticação. Dados do usuário e operações de aprendizagem exigem JWT bearer. Clientes OAuth usam authorization code com PKCE; o registro de produção é revisado para proteger dados e cotas.
Para acesso de integração, registro OAuth ou segurança, escreva para support@ahatranslator.com.
Respostas de erro
Operações JSON com falha devolvem `{ code, message, hint }`. Trate `code` (por exemplo UNAUTHORIZED, INVALID_REQUEST, FEATURE_LIMIT_REACHED). `message` é fallback para clientes antigos; `hint` diz ao agente como se recuperar. Não mostre `message` cru na UI do produto.