{
  "name": "Midvash API Pública",
  "version": "1.0.0",
  "description": "API pública para acesso a versículos e versões da Bíblia",
  "endpoints": {
    "GET /": {
      "description": "Documentação da API (este endpoint)",
      "example": "https://api.midvash.com/"
    },
    "GET /versions": {
      "description": "Lista todas as versões bíblicas disponíveis",
      "example": "https://api.midvash.com/versions",
      "response": {
        "versions": [
          {
            "slug": "nvi",
            "name": "Nova Versão Internacional",
            "shortName": "NVI",
            "language": "pt-br",
            "hasOldTestament": true,
            "hasNewTestament": true,
            "totalBooks": 66,
            "totalChapters": 1036
          }
        ]
      }
    },
    "GET /books": {
      "description": "Lista todos os livros da Bíblia",
      "example": "https://api.midvash.com/books",
      "response": {
        "books": [
          {
            "id": 1,
            "name": {
              "en": "Genesis",
              "pt-br": "Gênesis",
              "es": "Génesis"
            },
            "slug": {
              "en": "genesis",
              "pt-br": "genesis",
              "es": "genesis"
            },
            "chapters": 50,
            "testament": "old",
            "category": "pentateuch"
          }
        ]
      }
    },
    "GET /{version}/{book}/{chapter}": {
      "description": "Retorna um capítulo completo",
      "example": "https://api.midvash.com/nvi/john/3",
      "parameters": {
        "version": "Slug da versão (ex: nvi, kjv, niv)",
        "book": "Slug do livro (ex: john, genesis, psalms)",
        "chapter": "Número do capítulo"
      },
      "response": {
        "version": "nvi",
        "book": "john",
        "bookName": "John",
        "chapter": 3,
        "verses": [
          "Versículo 1...",
          "Versículo 2..."
        ]
      }
    },
    "GET /{version}/{book}/{chapter}/{verse}": {
      "description": "Retorna um versículo específico",
      "example": "https://api.midvash.com/nvi/john/3/16",
      "parameters": {
        "version": "Slug da versão",
        "book": "Slug do livro",
        "chapter": "Número do capítulo",
        "verse": "Número do versículo"
      },
      "response": {
        "version": "nvi",
        "book": "john",
        "bookName": "John",
        "chapter": 3,
        "verse": 16,
        "verseEnd": 16,
        "text": "Porque Deus amou o mundo...",
        "reference": "John 3:16"
      }
    },
    "GET /{version}/{book}/{chapter}/{verse-start}-{verse-end}": {
      "description": "Retorna um intervalo de versículos",
      "example": "https://api.midvash.com/nvi/john/3/16-20",
      "parameters": {
        "version": "Slug da versão",
        "book": "Slug do livro",
        "chapter": "Número do capítulo",
        "verse-start": "Versículo inicial",
        "verse-end": "Versículo final"
      },
      "response": {
        "version": "nvi",
        "book": "john",
        "bookName": "John",
        "chapter": 3,
        "verse": 16,
        "verseEnd": 20,
        "text": "Porque Deus amou o mundo... Versículo 17...",
        "reference": "John 3:16-20"
      }
    },
    "GET /characters": {
      "description": "Lista todos os personagens bíblicos",
      "example": "https://api.midvash.com/characters?locale=pt-br",
      "parameters": {
        "locale": "Idioma (en, pt-br, es) - opcional, padrão: en. Aceita também \"pt\" que será normalizado para \"pt-br\""
      },
      "response": {
        "characters": [
          {
            "id": 1,
            "name": "Jesus",
            "nameEn": "Jesus",
            "namePtBr": "Jesus",
            "nameEs": "Jesús",
            "slug": "jesus",
            "slugEn": "jesus",
            "slugPtBr": "jesus",
            "slugEs": "jesús",
            "imageUrl": "https://..."
          }
        ],
        "total": 50
      }
    },
    "GET /dictionary": {
      "description": "Lista todos os termos do dicionário bíblico",
      "example": "https://api.midvash.com/dictionary?locale=pt-br",
      "parameters": {
        "locale": "Idioma (en, pt-br, es) - opcional, padrão: en. Aceita também \"pt\" que será normalizado para \"pt-br\""
      },
      "response": {
        "terms": [
          {
            "id": 1,
            "term": "Graça",
            "termEn": "Grace",
            "termPtBr": "Graça",
            "termEs": "Gracia",
            "slug": "graca",
            "slugEn": "grace",
            "slugPtBr": "graca",
            "slugEs": "gracia"
          }
        ],
        "total": 100
      }
    }
  },
  "features": [
    "Cache máximo para dados imutáveis (TTL: 1 ano)",
    "CORS habilitado para acesso público",
    "Suporte a múltiplos idiomas (pt-br, en, es)",
    "35+ versões bíblicas disponíveis",
    "Lista de personagens bíblicos",
    "Dicionário de termos bíblicos",
    "Acesso rápido via Cloudflare Edge Network"
  ],
  "notes": [
    "Todos os dados são imutáveis e estão em cache por 1 ano",
    "Use slugs em inglês para os livros (ex: john, genesis, psalms)",
    "A API aceita slugs de livros em diferentes idiomas",
    "Para listar versões disponíveis, acesse /versions"
  ]
}