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.
https://biblija.net/api/v1
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.
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.
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.
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.
/translationsLista 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 |
/passageUn pasaje por referencia en la traducción seleccionada.
| Parámetro | Obligatorio | Descripción |
|---|---|---|
translation | sí | Abreviatura de la traducción (p. ej. KJV, SSP). |
reference | sí | Referencia, p. ej. Jn 3,16, Mt 5,1-12 o Ps 23. |
format | no | Formato 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"]);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"]);/verse-of-the-dayVersí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"]);{
"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.
{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
| Código | HTTP | Significado |
|---|---|---|
missing_api_key / invalid_api_key | 401 | Clave ausente o incorrecta. |
invalid_translation / missing_parameter / invalid_format | 400 | Entrada incorrecta. |
reference_not_found / not_found | 404 | Sin coincidencia / endpoint desconocido. |
rate_limit_exceeded | 429 | Límite diario superado. |