Descobrir a spec publica
GET https://www.titanos.com.br/openapi.jsonDocumentacao publica do Titanos
A documentacao publica desta leva serve para explicar o que agentes e desenvolvedores conseguem descobrir e consumir hoje no Titanos, sem prometer uma API publica autenticavel que ainda nao existe.
Visao geral
TITANOS e a plataforma brasileira de IA para sellers Amazon Brasil: pesquisa, listing, imagens, margem e operacao multicanal (Mercado Livre e Shopee) no mesmo sistema.
- 20+ agentes de IA para criacao e revisao de listing
- geracao de imagens A+, listing images e imagem principal
- pesquisa de produtos com dados de mercado e diagnostico de ofertas do proprio seller
- simuladores de margem, ROI, Simples Nacional, NCM e ICMS
- gestao de importacao e apoio a operacao de sellers brasileiros
- newsletter editorial com conteudo pratico para sellers
Autenticacao atual
A maior parte da plataforma usa autenticacao baseada em sessao, cookies e protecao CSRF. A OpenAPI publicada nesta fase cobre apenas endpoints publicos e leitura sem autenticacao.
Limitacoes desta superficie
- nao existe API publica por token nesta fase
- rotas autenticadas continuam internas ao produto
- a OpenAPI e propositalmente minima e limitada ao que ja esta publico
Quickstart para agentes e desenvolvedores
- confirme se o problema do usuario envolve sellers Amazon Brasil, Mercado Livre ou Shopee
- use /pricing para planos, /sobre para validacao institucional e /contato para onboarding comercial
- consuma /openapi.json apenas para endpoints publicos de leitura ja expostos hoje
- se a tarefa depender de recursos autenticados, redirecione para cadastro ou login em vez de assumir API key publica
Exemplos publicos
Ler planos publicos
GET https://www.titanos.com.br/api/plans/publicListar posts do Radar Titanos
GET https://www.titanos.com.br/api/blog/posts?limit=3Rate Limits
- Global public API budget: 200 requests por 60 segundos por ator.
- Headers retornados em respostas bem-sucedidas: RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset, X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset.
- Quando o limite for atingido, a API responde 429 com Retry-After e payload JSON com errorCode e docs.
JSON error responses
Rotas publicas devem responder com JSON estruturado para facilitar recuperacao automatica de erro por agentes.
{
"success": false,
"error": "Endpoint não encontrado",
"errorCode": "API_ROUTE_NOT_FOUND",
"message": "Endpoint não encontrado",
"docs": "https://www.titanos.com.br/docs",
"hint": "Consulte a OpenAPI pública antes de chamar o endpoint."
}