REST API za dostop do svetopisemskih besedil, vrstice dneva in seznama prevodov. Odgovori so v formatu JSON (UTF-8). Dostop je namenjen misijonskim partnerjem Svetopisemske družbe Slovenije.
https://biblija.net/api/v1
API ključi se dodeljujejo župnijam, skupnostim in drugim partnerskim organizacijam Svetopisemske družbe Slovenije na podlagi njihove prošnje. Za ključ zaprosi prek kontaktnega obrazca in opiši namen uporabe: kakšno aplikacijo ali storitev razvijaš, kateri prevodi te zanimajo in predviden obseg zahtev.
Za odobritev prošnje je potreben podpis sporazuma s Svetopisemsko družbo Slovenije, v katerem so določeni pogoji uporabe, navajanja vira itn. Ko prošnjo odobrimo, se v tvojem profilu (potrebna je prijava) pojavi možnost generiranja in regeneracije ključa.
Svetopisemska družba Slovenije je skrbnik slovenskih svetopisemskih prevodov. To vključuje skrb pred zlorabo svetopisemskih besedil, če bi jih uporabljali posamezniki ali skupine, katerih cilji so nasprotni od poslanstva Svetopisemske družbe in z njo povezanih cerkva.
Vsak zahtevek zahteva API ključ. Pošlji ga v glavi:
Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx
Alternativno je podprta tudi glava X-API-Key: <ključ>. Ključa nikoli ne pošiljaj v URL-ju.
100 zahtev na dan na ključ. Vsak odgovor vsebuje glave X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Ob preseženi meji vrne 429 in glavo Retry-After.
/translationsSeznam prevodov, ki so na voljo (z oznakami za parameter 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"]);Trenutno je prek API dosegljivih 28 prevodov. Seznam je vedno ažuren in se ujema z odgovorom endpointa zgoraj:
| Oznaka | Ime | Jezik |
|---|---|---|
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 |
/passageOdlomek po referenci v izbranem prevodu.
| Parameter | Obvezen | Opis |
|---|---|---|
translation | da | Oznaka prevoda (npr. KJV, SSP). |
reference | da | Referenca, npr. Jn 3,16, Mt 5,1-12 ali Ps 23. |
format | ne | Oblika besedila: text (privzeto, čisto besedilo), html (naš HTML markup) ali both (oboje). |
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 ali both). Vsak verz dobi polje html (izrisane oznake: imena Boga <span class="nd">, dodano besedilo <span class="add">, poetični odstavki <span class="q1"> …), celoten odlomek pa polje html z naslovi odsekov in oštevilčenimi vrsticami (<span class="verse"><sup class="verse-num">). Vračamo samo markup brez CSS — oblikovanje (npr. zamiki poezije, barva imen Boga) je prepuščeno tebi. Opombe in reference v HTML niso vključene. 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-dayVerz dneva. Neobvezni parameter translation (privzeto 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"
}
}
Z format=html ima vsak verz polje html namesto text, odgovor pa še odlomkov html (naslovi + oštevilčene vrstice):
{
"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": "..."
}
}
Pri knjigah, kjer se tiskana oznaka poglavja razlikuje od notranjega zaporedja (grška Estera: A, B, C …), reference navaja tiskano oznako, verz pa dobi še polje chapter_label; chapter ostane notranja številka.
{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
| Koda | HTTP | Pomen |
|---|---|---|
missing_api_key / invalid_api_key | 401 | Manjkajoč ali napačen ključ. |
invalid_translation / missing_parameter / invalid_format | 400 | Napačen vnos. |
reference_not_found / not_found | 404 | Ni zadetka / neznan endpoint. |
rate_limit_exceeded | 429 | Presežena dnevna meja. |