> ## 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.

# Novelfinished

> Disparado quando um assinante escolhe um final e conclui uma novela (`reading_progress.finished_at` passa de nulo para preenchido) — uma escrita discreta, então mapeia bem no modelo de Database Webhooks nativo do Supabase, descrito em [Modelo de autenticação sobre Supabase](/architecture/supabase-auth-model) (seção "Webhooks de saída"). Assinado via HMAC-SHA256, mesmo padrão da Platform API — a verificação passo a passo está em [Eventos (webhooks de saída)](/platform/overview#eventos-webhooks-de-saída).

**O que não existe (e por quê):** não há um webhook `chapter.unlocked`. O drip não é uma escrita — `unlocked_chapter_count()` é uma função calculada a cada leitura, sem nenhuma linha que muda no instante em que um capítulo libera às 06:00. Um Database Webhook não tem o que disparar nesse momento. Notificar "seu próximo capítulo chegou" exigiria um job agendado que recalcula o estado de cada assinante ativo e compara contra o que já foi notificado — não está desenhado; fica como questão aberta de roadmap, não como funcionalidade prometida.



## OpenAPI

````yaml /novelai/openapi.yaml webhook novelFinished
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: {}
components:
  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

````