API

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.

Adresse de base

https://biblija.net/api/v1

Comment obtenir une clé d'API

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

À quelles traductions puis-je accéder ? L'accès via l'API n'est actuellement activé que pour les traductions dont les droits d'auteur appartiennent à la Société biblique de Slovénie et pour les traductions du domaine public.

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.

Authentification

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.

Limite de débit (rate limit)

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.

Points de terminaison

Exemples en :

GET /translations

Liste 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

GET /passage

Un passage par référence dans la traduction sélectionnée.

ParamètreRequisDescription
translationouiAbréviation de la traduction (p. ex. KJV, SSP).
referenceouiRéférence, p. ex. Jn 3,16, Mt 5,1-12 ou Ps 23.
formatnonFormat 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"]);
Sortie HTML (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"]);

GET /verse-of-the-day

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

Exemple de réponse

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

Erreurs

{ "error": { "code": "reference_not_found", "message": "Reference ni mogoče najti: ..." } }
CodeHTTPSignification
missing_api_key / invalid_api_key401Clé manquante ou invalide.
invalid_translation / missing_parameter / invalid_format400Entrée invalide.
reference_not_found / not_found404Aucun résultat / point de terminaison inconnu.
rate_limit_exceeded429Limite quotidienne dépassée.

← Retour à l'accueil