Consulta a posição de reprodução do assinante em uma novela
Nota de contrato pendente: este path usa subscribers (plural), enquanto a Platform API usa o singular (/subscriber-status/{id}). A escolha do path final é uma decisão em aberto do dono da API antes de qualquer implementação — este endpoint, como o resto deste arquivo, é roadmap.
Espelha a tabela real listening_progress — uma linha por (usuário, novela): capítulo atual (chapter_id, formato do catálogo do player, ex. t1-ch3) e posição em segundos dentro dele. É o mesmo mecanismo que já sincroniza “continuar de onde parou” entre dispositivos dentro do próprio app oficial hoje — esta API só expõe essa mesma leitura/ escrita para um sistema de parceiro, em vez do app falar direto com o Supabase.
Authorizations
Client credentials — emitido uma única vez, de forma centralizada, pela Platform API (POST https://api.googa.com.br/v1/oauth2/token, ver Platform — OAuth2). Este domínio (api.novelai.com.br, que também atende NovelAudio) só valida o token — via a chave pública do projeto Platform — nunca emite um token próprio. Este arquivo não redefine a operação de emissão, só declara os escopos novelaudio:* que também podem ser pedidos na mesma troca, ao lado dos novelai:*.
Path Parameters
Identificador do assinante no sistema do parceiro (não é o user_id interno da Googa).
Query Parameters
A granularidade real da tabela é (assinante, novela) — um assinante pode ter progresso em várias novelas ao mesmo tempo, então é preciso informar qual.