API

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.

Adreça base

https://biblija.net/api/v1

Com obtenir una clau d'API

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.

A quines traduccions puc accedir? Actualment l'accés mitjançant l'API només està habilitat per a les traduccions els drets d'autor de les quals pertanyen a la Societat Bíblica d'Eslovènia i per a les traduccions de domini públic.

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.

Autenticació

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.

Límit de peticions (rate limit)

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.

Endpoints

Exemples en:

GET /translations

Llista 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

GET /passage

Un passatge per referència en la traducció seleccionada.

ParàmetreObligatoriDescripció
translationsíAbreviatura de la traducció (p. ex. KJV, SSP).
referencesíReferència, p. ex. Jn 3,16, Mt 5,1-12 o Ps 23.
formatnoFormat 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"]);
Sortida HTML (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"]);

GET /verse-of-the-day

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

Exemple de resposta

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

Errors

{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
CodiHTTPSignificat
missing_api_key / invalid_api_key401Clau absent o incorrecta.
invalid_translation / missing_parameter / invalid_format400Entrada incorrecta.
reference_not_found / not_found404Sense coincidència / endpoint desconegut.
rate_limit_exceeded429Límit diari superat.

← Torna a l'inici