Biblia pre vaše aplikácie a weby
Oficiálne texty slovenských prekladov Biblie priamo od vydavateľa – kapitoly, verše, nadpisy, poznámky a krížové odkazy cez jednoduché API. Teraz s Ekumenickým prekladom, ďalšie preklady pribudnú.
# verš podľa slovenskej referencie curl -H "X-Api-Key: dbk_…" \ "https://data.biblia.sk/api/v1/bibles/seb/text?ref=Jn 3,16" { "data": { "reference": "Jn 3,16", "text": "Veď Boh tak miloval svet, že dal svojho jednorodeného Syna, aby nik, kto verí v neho, nezahynul, ale mal večný život." }, "meta": { "copyright": "Slovenská biblická spoločnosť © …" } }
Ekumenický preklad
Slovenský ekumenický preklad, štvrté opravené vydanie, 2017. Celý text vrátane deuterokánonických kníh, so všetkými nadpismi, poznámkami a krížovými odkazmi.
Čo API ponúka
Od jedného verša v čistom texte až po celé kapitoly so štruktúrou na vlastné vykreslenie.
Oficiálny a aktuálny text
Priamo od Slovenskej biblickej spoločnosti. Každá oprava textu sa v API prejaví hneď, bez vašej práce.
Slovenské referencie
Píšte tak, ako ste zvyknutí: Jn 3,16-18, Ž 23, 1 Kor 13,4-7. Alebo medzinárodné ID JHN.3.16.
Jednoduchý čistý text
Jedna požiadavka, jeden riadok textu – bez poznámok a formátovania. Aj ako holý text bez JSON.
Poznámky a krížové odkazy
Poznámky pod čiarou a odkazy na súvisiace miesta, každý odkaz s ID, ktoré priamo načíta jeho text.
Štruktúra na vykreslenie
Odseky, riadky poézie, citáty, nadpisy oddielov a miesta poznámok – vykreslíte text ako v tlačenej Biblii.
Ďalšie preklady
Ponuka sa bude rozširovať. Všetky preklady budú mať rovnaké rozhranie – líšia sa iba ID prekladu.
Vyskúšajte si to
Skutočné odpovede API. Ukážka pracuje s vybranými kapitolami (Gn 1, Ž 23, Iz 53, Mt 5, Jn 3, 1Kor 13); s vlastným kľúčom máte celý preklad.
…
Ako začať
Vyberte si balík
Podľa toho, koľko požiadaviek mesačne potrebujete.
Dostanete prístup do účtu
V účte si vytvoríte API kľúč a sledujete spotrebu. Kľúč posielate v hlavičke X-Api-Key.
Načítajte text
Jednou požiadavkou. Pri texte uveďte copyright, ktorý vráti API.
curl -H "X-Api-Key: VÁŠ_KĽÚČ" \ "https://data.biblia.sk/api/v1/bibles/seb/text?ref=Ž%2023,1-3"
const res = await fetch('https://data.biblia.sk/api/v1/bibles/seb/text?ref=' + encodeURIComponent('Ž 23,1-3'), {
headers: { 'X-Api-Key': 'VÁŠ_KĽÚČ' },
});
const { data, meta } = await res.json();
console.log(data.text, '—', meta.copyright);
$response = file_get_contents('https://data.biblia.sk/api/v1/bibles/seb/text?ref=' . urlencode('Ž 23,1-3'), false,
stream_context_create(['http' => ['header' => "X-Api-Key: VÁŠ_KĽÚČ\r\n"]]));
$json = json_decode($response, true);
echo $json['data']['text'], ' — ', $json['meta']['copyright'];
Všetky endpointy, parametre a chyby nájdete v dokumentácii.
Balíky a ceny
Mesačné predplatné, ceny vrátane DPH. Nevyčerpané požiadavky sa neprenášajú.
Základný
Vhodný pre: Weby zborov, farností a organizácií, verš dňa a menšie aplikácie – približne do 150 používateľov aplikácie denne alebo 600 zobrazení stránky denne.
- 20 000 požiadaviek mesačne
- 300 požiadaviek za minútu
- 5 API kľúčov
- text, nadpisy, poznámky, krížové odkazy
- vlastný účet: spotreba, limity a správa kľúčov
Rozšírený
Vhodný pre: Aplikácie na čítanie Biblie a navštevovanejšie weby – približne do 1 500 používateľov aplikácie denne alebo 6 000 zobrazení stránky denne.
- 200 000 požiadaviek mesačne
- 1 200 požiadaviek za minútu
- 10 API kľúčov
- text, nadpisy, poznámky, krížové odkazy
- vlastný účet: spotreba, limity a správa kľúčov
Partner
Vhodný pre: Veľké aplikácie, vydavatelia a inštitúcie, ktoré potrebujú viac požiadaviek alebo individuálne podmienky.
- počet požiadaviek podľa dohody
- 3 000 požiadaviek za minútu
- 20 API kľúčov
- text, nadpisy, poznámky, krížové odkazy
- vlastný účet: spotreba, limity a správa kľúčov
- individuálne podmienky
Platíte bankovým prevodom na základe zálohovej faktúry, mesačne alebo ročne. Prístup aktivujeme po prijatí platby a pošleme vám e-mail s prihlásením do účtu, kde si vytvoríte API kľúč. Otázky: office@biblia.sk. Platia obchodné podmienky a podmienky používania. Spotrebiteľ môže od zmluvy odstúpiť do 14 dní.
Časté otázky
Môžem si text uložiť do vlastnej databázy alebo aplikácie?
Text nie – načítava sa z API pri každom zobrazení; vďaka tomu majú vaši používatelia vždy aktuálne znenie a my vieme chrániť autorské práva. Zoznam prekladov, kníh a kapitol si však uložiť môžete (obnovte ho aspoň raz za 30 dní), takže na ne nemíňate požiadavky. Podrobnosti sú v podmienkach používania.
Ako zaplatím?
Bankovým prevodom. Po odoslaní objednávky vám pošleme zálohovú faktúru; platiť môžete mesačne alebo ročne (pri ročnej platbe máte jeden mesiac zadarmo). Hneď po prijatí platby prístup aktivujeme.
Kde uvidím svoju spotrebu?
Vo svojom účte – prihlásite sa odkazom z e-mailu a vidíte balík, spotrebu po dňoch, zostávajúce požiadavky a svoje API kľúče, ktoré si sami vytvárate a rušíte. Spotrebu vráti aj API cez /usage.
Musím uvádzať copyright?
Áno, pri každom zobrazenom texte (stačí raz na stránke alebo obrazovke). Presné znenie vráti API v každej odpovedi v poli meta.copyright.
Môžem text použiť na umelú inteligenciu?
Nie. Text sa nesmie používať na trénovanie modelov, vektorové databázy, RAG ani na syntézu reči.
Dá sa API volať priamo z webovej stránky?
Áno, API povoľuje volania z prehliadača. Kľúč v JavaScripte je však viditeľný, preto si ho nechajte obmedziť na vaše domény – potom bude fungovať iba z vášho webu.
Pribudnú ďalšie preklady?
Áno, ponuka sa bude rozširovať. Nové preklady budú mať rovnaké rozhranie, takže ich do aplikácie pridáte zmenou jedného identifikátora.
Čo sa stane, keď miniem mesačný limit?
API odpovie chybou 429 až do začiatku ďalšieho mesiaca. Ak potrebujete viac, môžete kedykoľvek prejsť na vyšší balík. Stav limitu vidíte v hlavičkách každej odpovede.