API

Una API REST para acceder a los textos bíblicos, el versículo del día y la lista de traducciones. Las respuestas están en formato JSON (UTF-8). El acceso está destinado a los socios misioneros de la Sociedad Bíblica de Eslovenia.

Dirección base

https://biblija.net/api/v1

Cómo obtener una clave de API

Las claves de API se conceden, previa solicitud, a parroquias, comunidades y otras organizaciones asociadas de la Sociedad Bíblica de Eslovenia. Para solicitar una clave, escríbenos a través del formulario de contacto y describe el uso previsto: qué aplicación o servicio estás desarrollando, qué traducciones te interesan y el volumen de peticiones previsto.

La aprobación de la solicitud requiere la firma de un acuerdo con la Sociedad Bíblica de Eslovenia, en el que se establecen las condiciones de uso, la cita de la fuente, etc. Una vez aprobada tu solicitud, en tu perfil (es necesario iniciar sesión) aparece la opción de generar y regenerar la clave.

¿A qué traducciones puedo acceder? Actualmente el acceso mediante la API solo está habilitado para las traducciones cuyos derechos de autor pertenecen a la Sociedad Bíblica de Eslovenia y para las traducciones de dominio público.

La Sociedad Bíblica de Eslovenia es la custodia de las traducciones bíblicas eslovenas. Esto incluye la protección frente al uso indebido de los textos bíblicos por parte de personas o grupos cuyos objetivos sean contrarios a la misión de la Sociedad Bíblica y de las iglesias asociadas a ella.

Autenticación

Cada petición requiere una clave de API. Envíala en la cabecera:

Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx

Como alternativa también se admite la cabecera X-API-Key: <clave>. Nunca envíes la clave en la URL.

Límite de peticiones (rate limit)

100 peticiones al día por clave. Cada respuesta contiene las cabeceras X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Al superar el límite, devuelve 429 y la cabecera Retry-After.

Endpoints

Ejemplos en:

GET /translations

Lista de las traducciones disponibles (con las abreviaturas para el parámetro translation).

curl -H "Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://biblija.net/api/v1/translations"
const res = await fetch("https://biblija.net/api/v1/translations", {
  headers: { Authorization: "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" }
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(data);
import requests

r = requests.get(
    "https://biblija.net/api/v1/translations",
    headers={"Authorization": "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"}, timeout=10)
r.raise_for_status()
print(r.json()["data"])
<?php
$ch = curl_init("https://biblija.net/api/v1/translations");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);

Actualmente hay 28 traducciones disponibles a través de la API. Esta lista siempre está actualizada y coincide con la respuesta del endpoint anterior:

Abreviatura Nombre Idioma
SSP Slovenian Standard Version SLV
SSP-Op SSP - Study notes SL
SSP-Ref SSP - Cross References SL
ŽJ Life with Jesus NT SLV
JUB Jubilee Translation SLV
EKU Ecumenical Edition SLV
CHR Chraska Bible SLV
BSB Berean Standard Bible ENG
KJV King James Version ENG
ASV American Standard Version ENG
SEG Louis Segond (1910) FR
RUS Russian Synodal Version (1876) RU
DAL Dalmatin Bible (1584) SLV
LUT45 Luther (1545) DE
LUT12 Luther (1912) DEU
WEB World English Bible ENG
WLF Wolfova Biblija (1856-59) SL
JAP Japljeva Biblija (1784-1802) SL
VLC Vulgata Clementina (1592) LA
TRB Trubarjeva NZ in Ps (1555-1577) SL
PREK28 Prekmurian NT and Ps (1928) SLV
GWH Greek New Testament Westcott-Hort (1885) GRC
GTR Greek Textus Receptus GRC
LXX-Eng Brenton English LXX (1851) ENG
LXX-Sl Septuagint (Slovenian Edition 2026) GRC
LXX-Sl-A Septuagint (Slovenian Edition 2026), alternative texts GRC
LXX-Br Brenton Septuagint (1851) GRC
HEB Hebrew Old Testament HBO

GET /passage

Un pasaje por referencia en la traducción seleccionada.

ParámetroObligatorioDescripción
translationsíAbreviatura de la traducción (p. ej. KJV, SSP).
referencesíReferencia, p. ej. Jn 3,16, Mt 5,1-12 o Ps 23.
formatnoFormato del texto: text (predeterminado, texto plano), html (nuestro marcado HTML) o both (ambos).
curl -H "Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://biblija.net/api/v1/passage?translation=KJV&reference=Jn%203,16"
const res = await fetch("https://biblija.net/api/v1/passage?translation=KJV&reference=Jn%203,16", {
  headers: { Authorization: "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" }
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(data);
import requests

r = requests.get(
    "https://biblija.net/api/v1/passage?translation=KJV&reference=Jn%203,16",
    headers={"Authorization": "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"}, timeout=10)
r.raise_for_status()
print(r.json()["data"])
<?php
$ch = curl_init("https://biblija.net/api/v1/passage?translation=KJV&reference=Jn%203,16");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);
Salida HTML (format=html o both). Cada versículo obtiene un campo html (marcado renderizado: nombres de Dios <span class="nd">, texto añadido <span class="add">, párrafos poéticos <span class="q1"> …), y el pasaje completo obtiene un campo html con los títulos de sección y los versículos numerados (<span class="verse"><sup class="verse-num">). Devolvemos solo el marcado, sin CSS — el formato (p. ej. sangrías de la poesía, color de los nombres de Dios) queda a tu cargo. Las notas y las referencias no se incluyen en el HTML.
curl -H "Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://biblija.net/api/v1/passage?translation=SSP&reference=Mt%205,1-3&format=html"
const res = await fetch("https://biblija.net/api/v1/passage?translation=SSP&reference=Mt%205,1-3&format=html", {
  headers: { Authorization: "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" }
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(data);
import requests

r = requests.get(
    "https://biblija.net/api/v1/passage?translation=SSP&reference=Mt%205,1-3&format=html",
    headers={"Authorization": "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"}, timeout=10)
r.raise_for_status()
print(r.json()["data"])
<?php
$ch = curl_init("https://biblija.net/api/v1/passage?translation=SSP&reference=Mt%205,1-3&format=html");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);

GET /verse-of-the-day

Versículo del día. Parámetro translation opcional (predeterminado SSP).

curl -H "Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" \
  "https://biblija.net/api/v1/verse-of-the-day?translation=KJV"
const res = await fetch("https://biblija.net/api/v1/verse-of-the-day?translation=KJV", {
  headers: { Authorization: "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx" }
});
if (!res.ok) throw new Error((await res.json()).error.message);
const { data } = await res.json();
console.log(data);
import requests

r = requests.get(
    "https://biblija.net/api/v1/verse-of-the-day?translation=KJV",
    headers={"Authorization": "Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"}, timeout=10)
r.raise_for_status()
print(r.json()["data"])
<?php
$ch = curl_init("https://biblija.net/api/v1/verse-of-the-day?translation=KJV");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx"],
]);
$data = json_decode(curl_exec($ch), true);
print_r($data["data"]);

Ejemplo de respuesta

{
  "data": {
    "reference": "Jn 3,16",
    "translation": { "abbreviation": "KJV", "name": "King James Version", "language": "eng" },
    "verses": [
      {
        "book": "John", "book_abbrev": "Jhn", "chapter": 3, "verse": 16,
        "reference": "Jhn 3,16",
        "text": "For God so loved the world, ..."
      }
    ],
    "copyright": "Public Domain"
  }
}

Con format=html cada versículo tiene un campo html en lugar de text, y la respuesta tiene además el html del pasaje (títulos + versículos numerados):

{
  "data": {
    "reference": "Mt 5,1-3",
    "translation": { "abbreviation": "SSP", "name": "...", "language": "slv" },
    "verses": [
      { "book": "Matej", "book_abbrev": "Mt", "chapter": 5, "verse": 1,
        "reference": "Mt 5,1",
        "html": "Ko je zagledal množice, se je povzpel na goro. ..." }
    ],
    "html": "<h3 class=\"ms1\">Govor na gori</h3>\n<span class=\"verse\" data-ref=\"Mt 5,1\"><sup class=\"verse-num\">1</sup> Ko je zagledal množice ...</span>",
    "copyright": "..."
  }
}

En los libros cuya etiqueta de capítulo impresa difiere de la numeración interna (Ester griega: A, B, C…), reference usa la etiqueta impresa y el versículo lleva además el campo chapter_label; chapter sigue siendo el número interno.

Errores

{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
CódigoHTTPSignificado
missing_api_key / invalid_api_key401Clave ausente o incorrecta.
invalid_translation / missing_parameter / invalid_format400Entrada incorrecta.
reference_not_found / not_found404Sin coincidencia / endpoint desconocido.
rate_limit_exceeded429Límite diario superado.

← Volver al inicio