📖 Bible Dictionary API

API REST para consultar términos bíblicos de forma rápida, estructurada y escalable.

🌐 Live Demo  |  ⚡ API Base

---

🚀 Overview

Bible Dictionary API es un servicio REST diseñado para acceder a definiciones bíblicas de forma eficiente, escalable y fácil de integrar.

Pensado para:

• Aplicaciones web
• Apps móviles
• Plataformas educativas
• Sistemas backend
• Proyectos de investigación o estudio

---

🌐 Base URL

https://dictionarybible.vercel.app/api/dictionary

---

⚙️ Features

• 🔎 Búsqueda exacta por palabra
• 🔤 Filtrado por letra (A–Z)
• 🔍 Búsqueda global (full-text)
• 📦 Arquitectura modular por archivos
• ⚡ Cache en memoria para alto rendimiento
• 🌍 Listo para producción (Vercel deploy)
• 🧠 Normalización de texto (acentos, case-insensitive)

---

📦 API Endpoints

🔎 Search (recomendado)

GET /api/dictionary?search=amor

{
  "total": 2,
  "results": [
    {
      "word": "AMOR",
      "definitions": ["..."]
    }
  ]
}

---

📌 Get by word

GET /api/dictionary?word=dios

{
  "word": "DIOS",
  "definitions": ["..."]
}

---

🔤 Filter by letter

GET /api/dictionary?letter=b

{
  "BABEL": { "...": "..." },
  "BAUTISMO": { "...": "..." }
}

---

📚 Get full dataset

GET /api/dictionary

{
  "totalLetters": 26,
  "data": {
    "a": { "...": "..." },
    "b": { "...": "..." }
  }
}

---

🧪 Quick Start

const res = await fetch(
  "https://dictionarybible.vercel.app/api/dictionary?search=fe",
);

const data = await res.json();

console.log(data);

---

⚠️ Error Handling

Code	Meaning
404	Resource not found
500	Internal server error

{
  "error": "Palabra no encontrada"
}

---

🧠 Architecture

• Dataset dividido por letras (/data/a.json, /data/b.json, etc.)
• Lazy loading bajo demanda
• Cache en memoria para optimizar performance
• Normalización de texto (acentos, espacios, case-insensitive)
• Diseño preparado para escalar a dataset grande

---

📈 Roadmap

• 🔐 Authentication + rate limiting
• 📊 Analytics de consultas
• 🌍 Multi-language support
• 🧠 Búsqueda por relevancia (smart search)
• 📝 Admin dashboard para gestión de contenido

---

🤝 Contributing

Las contribuciones son bienvenidas.

Si quieres hacer cambios importantes, abre primero un issue para discusión.

---

📫 Contact

  

---

📄 License

MIT License © 2026 Franco Ortega

---

⚡ Philosophy

Construido como un producto real.

Simple, útil y escalable.