> ## Documentation Index > Fetch the complete documentation index at: https://developers.googa.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Finais disponíveis de uma novela para um assinante > Os finais só existem, do ponto de vista de conteúdo, quando o drip libera o último capítulo **para aquele assinante especificamente** — é por isso que `subscriber_id` é obrigatório aqui (diferente de `GET /novels/{id}/chapters`, onde é opcional): não há metadado de finais que possa ser mostrado sem gate, porque o próprio rótulo (`label`) de um final pode ser espoiler. Enquanto o assinante não chegou lá, a resposta é `200` com `available: false` e `choices` vazio — não é um erro, é um estado de negócio normal (a maior parte das chamadas a este endpoint vai cair aqui, para qualquer novela ainda em andamento). ## OpenAPI ````yaml /novelai/openapi.yaml get /novels/{id}/choices openapi: 3.1.0 info: title: Googa NovelAI API version: 1.0.0 summary: >- API específica de produto para NovelAI — catálogo de novelas seriadas, capítulos liberados pelo drip diário, progresso de leitura por assinante e os finais disponíveis. Não repete Entitlements, Billing ou SSO — isso é resolvido uma única vez pela Platform API (ver aba API Platform); esta especificação cobre apenas o que é específico de conteúdo/leitura do NovelAI. description: >- Hoje o catálogo, os capítulos e o progresso de leitura são consumidos diretamente pelo app oficial (Web/PWA — não há apps nativos) contra o Supabase do projeto "Novel", via Row Level Security. Esta especificação é um **contrato proposto, ainda não implementado**: descreve como um sistema terceiro (como o app da operadora) leria esses mesmos dados sem acesso direto ao banco. Ver [Modelo de autenticação sobre Supabase](/architecture/supabase-auth-model) para o desenho de autenticação completo. Esta é uma API **somente leitura** do ponto de vista do parceiro: nenhum endpoint aqui escreve em `reading_progress`, `subscriptions` ou qualquer outra tabela de domínio do leitor — isso continua sendo decisão do app oficial e, para os aspectos de assinatura/plano, da Platform API (`POST /entitlements`). O parceiro lê catálogo, capítulos liberados e progresso; não empurra leitura. NovelAI e NovelAudio compartilham o mesmo projeto Supabase ("Novel") e o mesmo domínio `api.novelai.com.br` — os recursos de streaming e player de áudio (voz, posição de reprodução, download offline) são documentados na aba NovelAudio, não aqui, ainda que fisicamente sejam a mesma API. contact: name: Googa — Suporte a parceiros email: developers@googa.com.br license: name: Uso restrito — ver Política de Uso da API url: https://developers.googa.com.br/security/api-usage-policy servers: - url: https://api.novelai.com.br/v1 description: Produção (proposto) - url: https://sandbox.novelai.com.br/v1 description: Sandbox (proposto) — catálogo fictício, sem impacto em billing real security: - partnerOAuth2: [] tags: - name: Catalog description: Catálogo público de categorias e novelas — metadados, sem gate de drip. - name: Chapters description: Capítulos de uma novela e seu estado de liberação (drip) por assinante. - name: Progress description: Progresso de leitura consolidado por assinante, entre novelas. - name: Choices description: >- Finais disponíveis de uma novela — só aparecem quando o drip libera o último capítulo. - name: Analytics description: >- Métricas agregadas de engajamento por parceiro — nunca por leitor identificável. paths: /novels/{id}/choices: get: tags: - Choices summary: Finais disponíveis de uma novela para um assinante description: >- Os finais só existem, do ponto de vista de conteúdo, quando o drip libera o último capítulo **para aquele assinante especificamente** — é por isso que `subscriber_id` é obrigatório aqui (diferente de `GET /novels/{id}/chapters`, onde é opcional): não há metadado de finais que possa ser mostrado sem gate, porque o próprio rótulo (`label`) de um final pode ser espoiler. Enquanto o assinante não chegou lá, a resposta é `200` com `available: false` e `choices` vazio — não é um erro, é um estado de negócio normal (a maior parte das chamadas a este endpoint vai cair aqui, para qualquer novela ainda em andamento). operationId: getNovelChoices parameters: - $ref: '#/components/parameters/NovelId' - name: subscriber_id in: query required: true schema: type: string description: Identificador do assinante no sistema do parceiro. responses: '200': description: Estado dos finais para este assinante. content: application/json: schema: $ref: '#/components/schemas/NovelChoices' '401': $ref: '#/components/responses/Unauthorized' '404': description: >- Novela inexistente, ou `subscriber_id` nunca visto por este parceiro. content: application/json: schema: $ref: '#/components/schemas/Error' components: parameters: NovelId: name: id in: path required: true schema: type: string description: Identificador (slug) da novela — ex. `t1`. schemas: NovelChoices: type: object properties: novel_id: type: string available: type: boolean description: >- `true` somente quando o último capítulo já liberou para este assinante. chosen_choice_id: type: string nullable: true description: >- Final já escolhido por este assinante, se `reading_progress.finished_at` estiver preenchido. choices: type: array items: $ref: '#/components/schemas/ChoiceOption' Error: type: object description: >- Mesmo formato de erro (estilo OAuth2, RFC 6749 §5.2) usado pela Platform API. properties: error: type: string example: invalid_request error_description: type: string example: Novela inexistente ou removida do catálogo ChoiceOption: type: object properties: choice_id: type: string label: type: string ending: type: string nullable: true description: Texto do desfecho correspondente a esta escolha. sort_order: type: integer responses: Unauthorized: description: Credenciais ausentes, inválidas ou expiradas. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: partnerOAuth2: type: oauth2 description: >- Client credentials — emitido **uma única vez**, de forma centralizada, pela Platform API (`POST https://api.googa.com.br/v1/oauth2/token`, ver aba API Platform). Este domínio (`api.novelai.com.br`) só *valida* o token — via a chave pública do projeto Supabase "Platform" — nunca emite um token próprio. Isso evita duplicar a verificação de `client_id`/`client_secret` em três projetos Supabase diferentes: o parceiro autentica uma vez, e o mesmo token (com os escopos certos) funciona em qualquer domínio de produto. Ver "Roteamento cross-projeto" em [Modelo de autenticação sobre Supabase](/architecture/supabase-auth-model#partner-gateway-a-camada-que-conecta-as-duas-pontas). flows: clientCredentials: tokenUrl: https://api.googa.com.br/v1/oauth2/token scopes: novelai:catalog:read: Ler catálogo (novelas e categorias) novelai:chapters:read: Ler capítulos e estado de liberação por assinante novelai:progress:read: Ler progresso de leitura consolidado por assinante novelai:choices:read: Ler finais disponíveis por assinante novelai:analytics:read: Ler métricas agregadas de engajamento ````