REST API v1

Documentação da API Mobile

API pública para integração com apps iOS, Android e qualquer plataforma. Autenticação via JWT do Supabase Auth.

Base URL

https://pnysqaw3a2bzjtz80fqd.helloreaddy.com//functions/v1

Autenticação

Todos os endpoints protegidos (marcados com Requer Auth) exigem um token JWT válido no header Authorization: Bearer <token>.

O token é obtido através do endpoint POST /mobile-auth?action=login e deve ser renovado via POST /mobile-auth?action=refresh antes de expirar.

Endpoints

Autentica um usuário com email e senha. Retorna tokens JWT e dados do perfil.

Parâmetros

NomeTipoObrigatórioDescrição
emailstringSimEmail cadastrado na conta GodoyProd
passwordstringSimSenha da conta

Exemplo de Requisição

curl -X POST https://pnysqaw3a2bzjtz80fqd.helloreaddy.com//functions/v1/mobile-auth?action=login \
  -H "Content-Type: application/json" \
  -d '{"email":"user@email.com","password":"senha123"}'

Exemplo de Resposta

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "refresh_token": "eyJhbGciOiJIUzI1NiIs...",
  "expires_at": 1716897600,
  "user": {
    "id": "uuid-do-usuario",
    "email": "user@email.com",
    "name": "João Silva",
    "avatar_url": "https://..."
  }
}

Fluxo de Integração

1

Login do Usuário

Envie email + password para /mobile-auth?action=login. Guarde access_token e refresh_token no Keychain/Keystore do dispositivo.

2

Verificar Sessão

A cada abertura do app, chame /mobile-auth?action=verify com o token atual. Se inválido, use o refresh_token.

3

Carregar Biblioteca

Chame /mobile-library?action=list com o token válido para obter todas as partituras compradas.

4

Acessar PDF

Para visualizar uma partitura, chame /mobile-pdf-access?action=url&item_id=XXX. A URL retornada pode ser aberta em um WebView ou baixada.

5

Sincronização Offline

Use /mobile-pdf-access?action=bulk com múltiplos item_ids para baixar vários PDFs de uma vez e armazenar localmente.