REST API bat Bibliako testuetara, eguneko bertsetera eta itzulpenen zerrendara sartzeko. Erantzunak JSON formatuan daude (UTF-8). Sarbidea Esloveniako Bibli Elkartearen misio-bazkideei zuzenduta dago.
https://biblija.net/api/v1
API gakoak Esloveniako Bibli Elkartearen parrokiei, komunitateei eta beste bazkide-erakunde batzuei ematen zaizkie, haien eskaeraren arabera. Gako bat eskatzeko, idatz iezaguzu harremanetarako inprimakiaren bidez eta azaldu erabileraren helburua: zein aplikazio edo zerbitzu garatzen ari zaren, zein itzulpen interesatzen zaizkizun eta aurreikusitako eskaera-kopurua.
Eskaera onartzeko, Esloveniako Bibli Elkartearekin hitzarmen bat sinatu behar da, non erabilera-baldintzak, iturriaren aipamena eta abar zehazten diren. Zure eskaera onartzen dugunean, gakoa sortzeko eta birsortzeko aukera zure profilean agertzen da (saioa hastea beharrezkoa da).
Esloveniako Bibli Elkartea esloveniar Bibliako itzulpenen zaindaria da. Horrek barne hartzen du Bibliako testuen erabilera okerraren aurkako babesa, Bibli Elkartearen eta harekin lotutako elizen helburuen aurka jotzen duten pertsona edo taldeek erabiliko balituzte.
Eskaera bakoitzak API gako bat behar du. Bidali goiburuan:
Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx
Alternatiba gisa, X-API-Key: <gakoa> goiburua ere onartzen da. Inoiz ez bidali gakoa URLan.
Eguneko 100 eskaera gako bakoitzeko. Erantzun bakoitzak X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset goiburuak ditu. Muga gaindituz gero, 429 eta Retry-After goiburua itzultzen ditu.
/translationsEskuragarri dauden itzulpenen zerrenda (translation parametroaren laburdurekin).
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"]);Une honetan 28 itzulpen daude eskuragarri APIaren bidez. Zerrenda hau beti eguneratuta dago eta goiko endpointaren erantzunarekin bat dator:
| Laburdura | Izena | Hizkuntza |
|---|---|---|
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 |
/passagePasarte bat erreferentziaren arabera, hautatutako itzulpenean.
| Parametroa | Beharrezkoa | Deskribapena |
|---|---|---|
translation | bai | Itzulpenaren laburdura (adib. KJV, SSP). |
reference | bai | Erreferentzia, adib. Jn 3,16, Mt 5,1-12 edo Ps 23. |
format | ez | Testu-formatua: text (lehenetsia, testu soila), html (gure HTML markaketa) edo both (biak). |
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 edo both). Bertset bakoitzak html eremua jasotzen du (errendatutako markaketa: Jainkoaren izenak <span class="nd">, gehitutako testua <span class="add">, paragrafo poetikoak <span class="q1"> …), eta pasarte osoak html eremua jasotzen du atalen izenburuekin eta zenbakitutako bertsetekin (<span class="verse"><sup class="verse-num">). Markaketa soilik itzultzen dugu, CSSrik gabe — formatua (adib. poesiaren koskak, Jainkoaren izenen kolorea) zure esku geratzen da. Oharrak eta erreferentziak ez daude HTMLan sartuta. 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-dayEguneko bertseta. translation parametro aukerakoa (lehenetsia 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"
}
}
format=html erabiliz, bertset bakoitzak html eremua du text-en ordez, eta erantzunak gainera pasartearen html du (izenburuak + zenbakitutako bertsetak):
{
"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": "..."
}
}
Inprimatutako kapitulu-etiketa barne-zenbakiketatik desberdina den liburuetan (Ester grekoa: A, B, C…), reference-k inprimatutako etiketa erabiltzen du eta bertsetak chapter_label eremua ere badu; chapter barne-zenbakia izaten jarraitzen du.
{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
| Kodea | HTTP | Esanahia |
|---|---|---|
missing_api_key / invalid_api_key | 401 | Gakoa falta da edo okerra da. |
invalid_translation / missing_parameter / invalid_format | 400 | Sarrera okerra. |
reference_not_found / not_found | 404 | Bat-etortzerik ez / endpoint ezezaguna. |
rate_limit_exceeded | 429 | Eguneko muga gaindituta. |