API

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.

Oinarrizko helbidea

https://biblija.net/api/v1

Nola lortu API gakoa

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).

Zein itzulpenetara sar naiteke? Gaur egun, API bidezko sarbidea Esloveniako Bibli Elkartearen egile-eskubideak dituzten itzulpenetarako eta domeinu publikoko itzulpenetarako baino ez dago gaituta.

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.

Autentikazioa

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.

Eskaera-muga (rate limit)

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.

Endpointak

Adibideak hemen:

GET /translations

Eskuragarri 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

GET /passage

Pasarte bat erreferentziaren arabera, hautatutako itzulpenean.

ParametroaBeharrezkoaDeskribapena
translationbaiItzulpenaren laburdura (adib. KJV, SSP).
referencebaiErreferentzia, adib. Jn 3,16, Mt 5,1-12 edo Ps 23.
formatezTestu-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"]);
HTML irteera (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"]);

GET /verse-of-the-day

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

Erantzunaren adibidea

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

Erroreak

{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
KodeaHTTPEsanahia
missing_api_key / invalid_api_key401Gakoa falta da edo okerra da.
invalid_translation / missing_parameter / invalid_format400Sarrera okerra.
reference_not_found / not_found404Bat-etortzerik ez / endpoint ezezaguna.
rate_limit_exceeded429Eguneko muga gaindituta.

← Hasierara itzuli