> ## 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. # Lista o catálogo de novelas > Metadados de catálogo — título, sinopse, categoria, tags editoriais e contagem de capítulos. Não inclui conteúdo de leitura (isso é gated por assinante; ver `GET /novels/{id}/chapters`) nem os finais (`GET /novels/{id}/choices`). Equivalente ao que `public.novels` mais `total_chapters()` expõem hoje ao app oficial. ## OpenAPI ````yaml /novelai/openapi.yaml get /novels 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: get: tags: - Catalog summary: Lista o catálogo de novelas description: >- Metadados de catálogo — título, sinopse, categoria, tags editoriais e contagem de capítulos. Não inclui conteúdo de leitura (isso é gated por assinante; ver `GET /novels/{id}/chapters`) nem os finais (`GET /novels/{id}/choices`). Equivalente ao que `public.novels` mais `total_chapters()` expõem hoje ao app oficial. operationId: listNovels parameters: - name: category_id in: query schema: type: string description: Filtra por categoria. Ver `GET /categories` para os valores válidos. example: turkish - name: tag in: query schema: type: string description: Filtra por tag editorial (`romance`, `aventura`, `rir`, ...). - name: has_audio in: query schema: type: boolean description: >- Filtra por novelas com narração real gravada — a flag `novels.has_real_audio`, a mesma que controla o catálogo do app NovelAudio — útil para um parceiro que quer destacar o cruzamento com a edição em áudio (NovelAudio). - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/PageSize' responses: '200': description: Página do catálogo. content: application/json: schema: type: object properties: data: type: array items: $ref: '#/components/schemas/NovelSummary' page: type: integer page_size: type: integer total: type: integer '401': $ref: '#/components/responses/Unauthorized' components: parameters: Page: name: page in: query schema: type: integer minimum: 1 default: 1 PageSize: name: page_size in: query schema: type: integer minimum: 1 maximum: 100 default: 20 schemas: NovelSummary: type: object properties: id: type: string example: t1 title: type: string description: type: string description: Sinopse curta (equivalente a `novels.description`). category_id: type: string tags: type: array items: type: string example: - romance - aventura chapter_count: type: integer description: >- Total de capítulos da novela (`total_chapters()`). Hoje toda novela do catálogo tem 7 capítulos de conteúdo (7 páginas cada) mais um capítulo final próprio (o 8º, só a escolha de desfecho, liberado no mesmo dia do 7º) — então o valor típico é 8. O campo não assume esse número: é contado a partir de `novel_chapters`, não hardcoded. has_audio_edition: type: boolean description: >- `true` quando a novela tem narração real gravada (`novels.has_real_audio`) — a mesma obra narrada, consumível via NovelAudio. cover_image_url: type: string format: uri nullable: true description: >- Hoje sempre `null`. As capas do catálogo (~112 títulos) são assets estáticos embutidos no build do app oficial (`src/data/covers.ts`), não arquivos servidos por um bucket ou CDN — não há hoje uma URL para devolver aqui. Expor este campo de verdade pressupõe migrar as capas para o Supabase Storage (ou um CDN próprio) antes; é uma lacuna conhecida deste roadmap, não apenas um campo "ainda não documentado". 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 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 ````