Una API REST per accedir als textos bíblics, el versicle del dia i la llista de traduccions. Les respostes són en format JSON (UTF-8). L'accés està destinat als socis missioners de la Societat Bíblica d'Eslovènia.
https://biblija.net/api/v1
Les claus d'API es concedeixen, prèvia sol·licitud, a parròquies, comunitats i altres organitzacions associades de la Societat Bíblica d'Eslovènia. Per sol·licitar una clau, escriu-nos a través del formulari de contacte i descriu l'ús previst: quina aplicació o servei estàs desenvolupant, quines traduccions t'interessen i el volum de peticions previst.
L'aprovació de la sol·licitud requereix la signatura d'un acord amb la Societat Bíblica d'Eslovènia, en què s'estableixen les condicions d'ús, la citació de la font, etc. Un cop aprovada la teva sol·licitud, al teu perfil (cal iniciar sessió) apareix l'opció de generar i regenerar la clau.
La Societat Bíblica d'Eslovènia és la dipositària de les traduccions bíbliques eslovenes. Això inclou la protecció contra l'ús indegut dels textos bíblics per part de persones o grups els objectius dels quals siguin contraris a la missió de la Societat Bíblica i de les esglésies associades a ella.
Cada petició requereix una clau d'API. Envia-la a la capçalera:
Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx
Com a alternativa també s'admet la capçalera X-API-Key: <clau>. No enviïs mai la clau a l'URL.
100 peticions al dia per clau. Cada resposta conté les capçaleres X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. En superar el límit, retorna 429 i la capçalera Retry-After.
/translationsLlista de les traduccions disponibles (amb les abreviatures per al paràmetre 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"]);Actualment hi ha 28 traduccions disponibles a través de l’API. Aquesta llista sempre està actualitzada i coincideix amb la resposta de l’endpoint anterior:
| Abreviatura | Nom | Llengua |
|---|---|---|
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 passatge per referència en la traducció seleccionada.
| Paràmetre | Obligatori | Descripció |
|---|---|---|
translation | sí | Abreviatura de la traducció (p. ex. KJV, SSP). |
reference | sí | Referència, p. ex. Jn 3,16, Mt 5,1-12 o Ps 23. |
format | no | Format del text: text (per defecte, text pla), html (el nostre marcatge HTML) o both (tots dos). |
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 versicle obté un camp html (marcatge renderitzat: noms de Déu <span class="nd">, text afegit <span class="add">, paràgrafs poètics <span class="q1"> …), i el passatge sencer obté un camp html amb els títols de secció i els versicles numerats (<span class="verse"><sup class="verse-num">). Retornem només el marcatge, sense CSS — el format (p. ex. sagnats de la poesia, color dels noms de Déu) queda a càrrec teu. Les notes i les referències no s'inclouen a l'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-dayVersicle del dia. Paràmetre translation opcional (per defecte 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"
}
}
Amb format=html cada versicle té un camp html en lloc de text, i la resposta té a més l'html del passatge (títols + versicles numerats):
{
"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 els llibres on l'etiqueta de capítol impresa difereix de la numeració interna (Ester grega: A, B, C…), reference fa servir l'etiqueta impresa i el versicle porta a més el camp chapter_label; chapter continua sent el número intern.
{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
| Codi | HTTP | Significat |
|---|---|---|
missing_api_key / invalid_api_key | 401 | Clau absent o incorrecta. |
invalid_translation / missing_parameter / invalid_format | 400 | Entrada incorrecta. |
reference_not_found / not_found | 404 | Sense coincidència / endpoint desconegut. |
rate_limit_exceeded | 429 | Límit diari superat. |