yomu API
========

API de obras e capítulos.

Base URL: http://localhost:3100


ROTAS
-----

GET /
  Esta documentação.

GET /health
  Status da API.
  Resposta: { ok, service }


── OBRAS ──────────────────────────────────────────

GET /obras
  Lista obras. Com q filtra por título.

  Query params:
    q  Termo de busca (opcional)

  Exemplo: GET /obras?q=solo+leveling

  Resposta:
    {
      total: number,
      data: Obra[]
    }

GET /obras/:id
  Retorna uma obra pelo ID.
  Inclui chapters[] com lista simplificada (id, number, title).

  Exemplo: GET /obras/abc123-...

  Resposta: ObraDetalhada

GET /obras/:id/capitulos
  Lista os capítulos de uma obra.

  Query params:
    q  Busca por título do capítulo (opcional)

  Exemplo: GET /obras/abc123-.../capitulos

  Resposta:
    {
      total: number,
      data: Capitulo[]
    }


── CAPÍTULOS ──────────────────────────────────────

GET /capitulos?obra_id=<id>
  Lista capítulos de uma obra.

  Query params:
    obra_id  ID da obra (obrigatório)
    q        Busca por título do capítulo (opcional)

  Exemplo: GET /capitulos?obra_id=abc123-...

  Resposta:
    {
      total: number,
      data: Capitulo[]
    }

GET /capitulos/:id
  Retorna um capítulo pelo ID.
  Inclui content[] com as URLs das imagens do capítulo.

  Exemplo: GET /capitulos/def456-...

  Resposta: Capitulo


── TIPOS PRINCIPAIS ───────────────────────────────

Obra {
  id:               string
  title:            string
  slug:             string
  description:      string
  coverImage:       string (URL)
  type:             string
  status:           string
  isAdult:          boolean
  isVip:            boolean
  rating:           number
  views:            number
  genres:           Array<{ genre: { id, name, slug } }>
  _count:           { chapters, comments, ratings, favoritedBy }
  createdAt:        string (ISO 8601)
  updatedAt:        string (ISO 8601)
}

ObraDetalhada extends Obra {
  chapters: Array<{ id, number, title }>
}

Capitulo {
  id:           string
  number:       number
  title:        string
  slug:         string
  content:      string[]  (URLs das imagens)
  seriesId:     string
  views:        number
  isVip:        boolean
  createdAt:    string (ISO 8601)
  updatedAt:    string (ISO 8601)
  series:       { id, title, slug, coverImage }
}


── ERROS ──────────────────────────────────────────

400  { error: "mensagem" }   — parâmetro ausente ou inválido
404  { error: "mensagem" }   — recurso não encontrado
502  { error: "mensagem" }   — erro na API do yomu.com.br