Nesta página
O que a integração faz
A Astorya roda dentro do app do parceiro, em uma WebView. O membro entra no seu app como sempre, toca em “Livros” e já cai logado na Astorya — sem cadastro, sem senha nova. Do seu lado, você controla quem tem acesso e recebe todo mês um relatório do que foi consumido.
Um caso típico: uma rede de academias oferece audiolivros como benefício do plano. Quando o usuário contrata, ele ganha acesso; quando cancela, o acesso é revogado; e a academia comprova mensalmente a entrega do conteúdo.
Quanto tempo leva? Um desenvolvedor costuma colocar o fluxo completo de pé em um dia: uma rota no seu backend, uma tela com WebView no app e um job mensal para os relatórios.
Os 3 blocos da integração
launchUrl e o app abre essa URL numa WebView. O membro já entra logado.
Gestão de usuários
Crie, atualize, bloqueie ou revogue o acesso de um membro pelo seu identificador (externalUserId).
Relatórios de uso
Totais e consumo por membro em cada mês: usuários ativos, títulos iniciados, tempo de escuta e capítulos lidos.
O catálogo também fica disponível pela API, caso você queira mostrar capas e títulos dentro das telas do seu próprio app.
URLs base
| Uso | URL | Quem chama |
|---|---|---|
| API de parceiros | https://api.astorya.com.br/partner/v1 | Somente o seu backend (servidor para servidor). |
| Astorya Web | https://play.astorya.com.br | A WebView do seu app, abrindo a launchUrl devolvida pela API. |
Todas as chamadas usam HTTPS, recebem e devolvem JSON (Content-Type: application/json) e datas no formato ISO 8601 em UTC (por exemplo, 2026-10-08T14:30:00.000Z).
Ambientes: produção e sandbox
Não existe um servidor separado para testes. O sandbox é um tenant à parte, com credenciais próprias, membros próprios e relatórios próprios — mas nas mesmas URLs. O ambiente é definido pela credencial que você usa.
Como as URLs são as mesmas, o erro mais comum é subir para produção com a credencial do sandbox. Deixe client_id e client_secret em variáveis de ambiente diferentes por ambiente e confira no painel qual credencial está em uso.
Por onde começar
- Faça o guia rápido
Em 15 minutos você gera uma credencial e abre a Astorya logada no navegador. Ir para o guia rápido.
- Entenda o login único
Como o membro é criado no primeiro acesso, o que acontece com o e-mail e quando o link expira. Login único (SSO).
- Coloque a WebView no app
Exemplos prontos para React Native, Flutter, iOS e Android. Embutir no app.
- Automatize acesso e relatórios
Revogue o acesso quando o plano for cancelado e baixe o relatório todo mês. Gestão de usuários e Relatórios de uso.