Daruj Trgovina

API

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.

Osnovni naslov

https://biblija.net/api/v1

Kako pridobiš API ključ

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.

Do katerih prevodov lahko dostopam? Trenutno je omogočen API dostop le do prevodov, katerih avtorske pravice pripadajo Svetopisemski družbi Slovenije, in do prevodov, ki so v javni lasti.

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.

Avtentikacija

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.

Omejitev (rate limit)

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.

Endpointi

Primeri v:

GET /translations

Seznam 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

GET /passage

Odlomek po referenci v izbranem prevodu.

ParameterObvezenOpis
translationdaOznaka prevoda (npr. KJV, SSP).
referencedaReferenca, npr. Jn 3,16, Mt 5,1-12 ali Ps 23.
formatneOblika 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"]);
HTML izpis (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"]);

GET /verse-of-the-day

Verz 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"]);

Primer odgovora

{
  "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.

Napake

{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
KodaHTTPPomen
missing_api_key / invalid_api_key401Manjkajoč ali napačen ključ.
invalid_translation / missing_parameter / invalid_format400Napačen vnos.
reference_not_found / not_found404Ni zadetka / neznan endpoint.
rate_limit_exceeded429Presežena dnevna meja.

← Nazaj na začetno stran