Documentación del API

Inicio rápido

Todas las rutas cuelgan de https://evanbible.com/api/v1, solo admiten GET y responden JSON. Prueba ahora mismo, sin key:

curl https://evanbible.com/api/v1/evbm/juan/3/16

{
    "ok": true,
    "version": "EVBM",
    "book": 43,
    "book_name": "Juan",
    "chapter": 3,
    "reference": "Juan 3:16",
    "count": 1,
    "verses": [
        {
            "verse": 16,
            "text": "Porque Dios amó al mundo de este modo: entregó a su unigénito Hijo, a fin de que cualquiera que crea en él no perezca, sino que obtenga vida eterna."
        }
    ]
}

Estructura de una ruta: /api/v1/{versión}/{libro}/{capítulo}/{versículo}. El libro acepta número (1–66), nombre o abreviatura.

Derechos y riesgos

El API ofrece dos tipos de textos, con garantías muy distintas:

Respuesta del API para una versión retirada:

{
    "ok": false,
    "error": "La versión 'XYZ' fue retirada por reclamo de su titular y no volverá a publicarse. Consulta https://evanbible.com/reclamos.php"
}

Programa tu integración para manejar el código 410: muestra un aviso o cambia a la Edición EvanBible.

Autenticación

La key es opcional. Sin key, cada IP tiene un límite diario; con una API key gratuita el límite es mayor. Envíala de una de estas dos formas:

# Recomendado: cabecera
curl -H "X-API-Key: TU_KEY" https://evanbible.com/api/v1/evbm/salmos/23

# Alternativa: parámetro (útil en enlaces o pruebas)
curl "https://evanbible.com/api/v1/evbm/salmos/23?key=TU_KEY"

Límites de uso

Cada respuesta incluye X-RateLimit-Limit y X-RateLimit-Remaining. Al superar el límite recibes 429; el contador se reinicia a medianoche (hora del servidor). EvanBible es gratuito: no hay planes ni cobros.

Respuestas y errores

Toda respuesta trae "ok". Los errores usan el código HTTP correspondiente y un mensaje legible:

{
    "ok": false,
    "error": "Versión 'XYZ' no encontrada. Consulta /api/v1/versions"
}

CORS: Access-Control-Allow-Origin: *, así que puedes llamar al API directamente desde el navegador.

Referencia de endpoints

{
    "ok": true,
    "count": 57,
    "notice": "EvanBible no cuenta con el derecho de distribuir, publicar ni alojar las versiones con rights=publisher…",
    "versions": [
        {
            "abbreviation": "EVBM",
            "name": "Edición EvanBible – Rey Jacobo en español (versión mejorada)",
            "language": "Español",
            "info_url": "https://evanbible.com/rey-jacobo.php",
            "rights": "cc-by-4.0",
            "download": "https://evanbible.com/descargar.php?v=evbm&f=json"
        },
        {
            "abbreviation": "XYZ",
            "name": "Versión de otro editor",
            "language": "Español",
            "info_url": null,
            "rights": "publisher",
            "download": null
        }
    ]
}

{
    "ok": true,
    "version": "EVBM",
    "count": 66,
    "books": [
        {
            "id": 1,
            "name": "Génesis",
            "abbreviation": "Gn",
            "testament": "O",
            "genre": "Ley"
        }
    ]
}

GET https://evanbible.com/api/v1/evbm/salmos
{
    "ok": true,
    "version": "EVBM",
    "book": 19,
    "name": "Salmos",
    "abbreviation": "Sal",
    "testament": "O",
    "chapters": 150,
    "verses": 2461
}

GET https://evanbible.com/api/v1/evbm/salmos/23
{
    "ok": true,
    "version": "EVBM",
    "book": 19,
    "book_name": "Salmos",
    "chapter": 23,
    "reference": "Salmos 23",
    "count": 6,
    "verses": [
        {
            "verse": 1,
            "text": "Jehová es mi pastor; no me hará falta nada."
        },
        {
            "verse": 2,
            "text": "Me hace reposar en verdes pastos; me conduce junto a aguas de reposo."
        },
        "…"
    ]
}

GET https://evanbible.com/api/v1/evbm/1-corintios/13/4-5
{
    "ok": true,
    "version": "EVBM",
    "book": 46,
    "book_name": "1 Corintios",
    "chapter": 13,
    "reference": "1 Corintios 13:4-5",
    "count": 2,
    "verses": [
        {
            "verse": 4,
            "text": "El amor sufre con paciencia y es bondadoso; el amor no envidia; el amor no se jacta, no se hincha,"
        },
        {
            "verse": 5,
            "text": "No obra con descortesía, no busca lo que es suyo, no se irrita con facilidad, no piensa el mal;"
        }
    ]
}

GET https://evanbible.com/api/v1/evbm/search?q=pastor&mode=todas&book=salmos&limit=2
{
    "ok": true,
    "version": "EVBM",
    "query": "pastor",
    "mode": "todas",
    "total": 5,
    "page": 1,
    "pages": 3,
    "limit": 2,
    "results": [
        {
            "book": 19,
            "book_name": "Salmos",
            "chapter": 23,
            "verse": 1,
            "reference": "Salmos 23:1",
            "text": "Jehová es mi pastor; no me hará falta nada."
        },
        "…"
    ]
}

{
    "ok": true,
    "version": "EVBM",
    "book": 20,
    "book_name": "Proverbios",
    "chapter": 3,
    "verse": 5,
    "reference": "Proverbios 3:5",
    "text": "Fía en Jehová con todo tu corazón; no te recuestes sobre tu propio entendimiento."
}

GET https://evanbible.com/api/v1/compare/juan/3/17?versions=EVBM,EVBC
{
    "ok": true,
    "book": {
        "id": 43,
        "name": "Juan"
    },
    "chapter": 3,
    "verse": 17,
    "reference": "Juan 3:17",
    "versions": {
        "EVBM": "Porque Dios no envió a su Hijo al mundo con el fin de condenar al mundo; antes bien, para que el mundo sea salvado por medio de él.",
        "EVBC": "…"
    }
}

Libros 1–66

Usa el número canónico siempre que puedas: es igual en todas las versiones e idiomas. También se aceptan el nombre (con o sin acentos, por ejemplo genesis), la abreviatura (Gn) o el inicio del nombre. Para nombres con número usa guion o espacio codificado: 1-corintios o 1%20corintios.

Códigos de versión

Usa el código en minúsculas o mayúsculas. La lista completa y actual está en /api/v1/versions y en Biblias disponibles.

Español

Afrikaans

Albanian

Bengali

Chinese

Czech

English

Greek

Gujarati

Hindi

Indonesian

Italian

Japanese

Kannada

Malayalam

Oriya

Pedi

Português

Punjabi

Tamil

Telugu

Vietnamese

Xhosa

Zulu

Edición EvanBible: descarga completa

Las versiones EVBM (mejorada) y EVBC (clásica) son traducciones propias con licencia CC BY 4.0: puedes descargarlas completas e integrarlas sin pedir permiso, citando la fuente.

# Formatos: json · js · sql · csv · txt · zip · licencia
curl -O "https://evanbible.com/descargar.php?v=evbm&f=json"

<!-- Módulo JavaScript sin dependencias -->
<script src="https://evanbible.com/descargar.php?v=evbm&f=js&inline=1"></script>
<script>
  EVB.versiculo('Juan', 3, 16);
  EVB.pasaje('Salmos 23:1-3');
  EVB.buscar('misericordia', 10);
</script>

Cita así: Edición EvanBible – Rey Jacobo en español (EVBM), evanbible.com. Si modificas el texto, indícalo y publícalo con otro nombre. Detalles en la página de la edición.

Ejemplos de código

JavaScript (navegador o Node 18+)

const res = await fetch('https://evanbible.com/api/v1/evbm/random', {
  headers: { 'X-API-Key': 'TU_KEY' }   // opcional
});
const d = await res.json();
if (!d.ok) throw new Error(d.error);
console.log(`«${d.text}» — ${d.reference} (${d.version})`);

PHP

$ctx  = stream_context_create(['http' => ['header' => "X-API-Key: TU_KEY\r\n"]]);
$json = file_get_contents('https://evanbible.com/api/v1/evbm/juan/3/16-17', false, $ctx);
$d    = json_decode($json, true);
foreach ($d['verses'] as $v) {
    echo $v['verse'] . ' ' . $v['text'] . PHP_EOL;
}

Python

import requests

r = requests.get("https://evanbible.com/api/v1/evbm/search",
                 params={"q": "luz mundo", "mode": "todas"},
                 headers={"X-API-Key": "TU_KEY"})
for v in r.json()["results"]:
    print(v["reference"], v["text"])

curl

curl "https://evanbible.com/api/v1/compare/salmos/23/1?versions=EVBM,EVBC"

Buenas prácticas

• Guarda en caché los capítulos y versículos: el texto no cambia de un día para otro.
• Usa números de libro (1–66) en lugar de nombres para evitar ambigüedades entre idiomas.
• Muestra la referencia que ya viene formateada en reference y la versión.
• Una key por proyecto y, al crearla, indica dónde la usarás: nos ayuda a conocer los proyectos que usan EvanBible.
• Respeta los derechos de cada versión: para mostrar textos completos o redistribuirlos, usa la Edición EvanBible o pide permiso al editor.
• Maneja el código 410: una versión de otro editor puede retirarse en cualquier momento por reclamo de su titular.

Para agentes de IA

Esta documentación existe en Markdown, pensada para modelos de lenguaje: /docs.md y /llms.txt. Siempre refleja las versiones publicadas.