Une API REST pour accéder aux textes bibliques, au verset du jour et à la liste des traductions. Les réponses sont au format JSON (UTF-8). L'accès est destiné aux partenaires missionnaires de la Société biblique de Slovénie.
https://biblija.net/api/v1
Les clés d'API sont attribuées sur demande aux paroisses, aux communautés et à d'autres organisations partenaires de la Société biblique de Slovénie. Pour obtenir une clé, écrivez-nous via le formulaire de contact et décrivez l'usage prévu : quelle application ou quel service vous développez, quelles traductions vous intéressent et le volume de requêtes attendu.
L'approbation d'une demande requiert la signature d'un accord avec la Société biblique de Slovénie, qui définit les conditions d'utilisation, l'attribution de la source, etc. Une fois votre demande approuvée, l'option de générer et de régénérer une clé apparaît dans votre profil (connexion requise).
La Société biblique de Slovénie est la gardienne des traductions bibliques slovènes. Cela inclut la protection contre l'usage abusif des textes bibliques par des personnes ou des groupes dont les objectifs sont contraires à la mission de la Société biblique et des Églises qui lui sont associées.
Chaque requête nécessite une clé d'API. Envoyez-la dans l'en-tête :
Authorization: Bearer bib_xxxxxxxxxxxxxxxxxxxxxxxx
L'en-tête X-API-Key: <clé> est également pris en charge comme alternative. N'envoyez jamais la clé dans l'URL.
100 requêtes par jour par clé. Chaque réponse contient les en-têtes X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset. Lorsque la limite est dépassée, elle renvoie 429 et l'en-tête Retry-After.
/translationsListe des traductions disponibles (avec les abréviations pour le paramètre 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"]);Actuellement, 28 traductions sont disponibles via l’API. Cette liste est toujours à jour et correspond à la réponse du point d’accès ci-dessus :
| Abréviation | Nom | Langue |
|---|---|---|
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 |
/passageUn passage par référence dans la traduction sélectionnée.
| Paramètre | Requis | Description |
|---|---|---|
translation | oui | Abréviation de la traduction (p. ex. KJV, SSP). |
reference | oui | Référence, p. ex. Jn 3,16, Mt 5,1-12 ou Ps 23. |
format | non | Format du texte : text (par défaut, texte brut), html (notre balisage HTML) ou both (les deux). |
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 ou both). Chaque verset reçoit un champ html (balisage rendu : noms de Dieu <span class="nd">, texte ajouté <span class="add">, paragraphes poétiques <span class="q1"> …), et le passage entier reçoit un champ html avec les titres de sections et les versets numérotés (<span class="verse"><sup class="verse-num">). Nous renvoyons uniquement le balisage, sans CSS — la mise en forme (p. ex. retraits de la poésie, couleur des noms de Dieu) vous est laissée. Les notes et les références ne sont pas incluses dans le 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"]);/verse-of-the-dayVerset du jour. Paramètre translation facultatif (par défaut 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"
}
}
Avec format=html, chaque verset a un champ html au lieu de text, et la réponse a en plus le html du passage (titres + versets numérotés) :
{
"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": "..."
}
}
Pour les livres dont le numéro de chapitre imprimé diffère de la numérotation interne (Esther grecque : A, B, C…), reference utilise le numéro imprimé et le verset porte en plus un champ chapter_label ; chapter reste le numéro interne.
{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
| Code | HTTP | Signification |
|---|---|---|
missing_api_key / invalid_api_key | 401 | Clé manquante ou invalide. |
invalid_translation / missing_parameter / invalid_format | 400 | Entrée invalide. |
reference_not_found / not_found | 404 | Aucun résultat / point de terminaison inconnu. |
rate_limit_exceeded | 429 | Limite quotidienne dépassée. |