Úvod Autentifikácia Biblia EGW (Súvislosti) Zoznam skratiek Chybové kódy Príklady integrácie

Úvod

Core API umožňuje programový prístup k viacerým prekladom Biblie a vybraným spisom Ellen G. Whiteovej. Toto API je navrhnuté pre vývojárov, ktorí chcú integrovať Písmo a komentáre EGW priamo do svojich projektov.

Základná URL adresa API:
https://casdzvolen.sk/kniznica/api/api_v1.php

Autentifikácia

Každá požiadavka na API musí obsahovať váš unikátny API kľúč v parametri URL. Bez platného kľúča bude požiadavka zamietnutá kódom 401 alebo 403.

GET https://casdzvolen.sk/kniznica/api/api_v1.php?api_key=VAS_KLUC&action=...

GETBiblia

Vráti text verša zo všetkých dostupných biblických prekladov (ROH, ECAV, BPD, CEP, PBK).

Povinné parametre:
ParameterPopis
action=fetchZákladná akcia pre získanie verša.
folderSkratka knihy (napr. MAT, 1MOJ).
chČíslo kapitoly.
vČíslo verša.

GETEGW (Súvislosti)

Unikátna funkcia, ktorá analyzuje biblický verš a vráti najrelevantnejšie súvisiace citáty z vybraných kníh E. G. Whiteovej.

Parametre:
  • action=cross_egw
  • folder, ch, v (identifikácia biblického verša)

Zoznam skratiek

Pre úspešné volanie API musíte v parametri folder použiť jednu z týchto skratiek:

Voliteľný parameter prekladu:

Použite parameter &trans=KÓD pre získanie textu len z konkrétnej Biblie.

Kód (trans)Názov prekladu
ROHRoháčkov preklad
ECAVEvanjelický preklad
BPDBiblia pre dnešok
CEPČeský ekumenický překlad
PBKBible kralická
Starý Zákon (SZ)
KnihaFolder
1. Mojžišova1MOJ
2. Mojžišova2MOJ
3. Mojžišova3MOJ
4. Mojžišova4MOJ
5. Mojžišova5MOJ
JozueJOZ
SudcoviaSUD
RútRUT
1. Samuelova1SAM
2. Samuelova2SAM
1. Kráľov1KRAL
2. Kráľov2KRAL
1. Paralipomenon1PAR
2. Paralipomenon2PAR
EzdrášEZD
NehemiášNEH
EsterEST
JóbJOB
ŽalmyZ
PrísloviaPRISL
KnihaFolder
KazateľKAZ
Pieseň ŠalamúnovaPIES
IzaiášIZ
JeremiášJER
Plač JeremiášovPLAC
EzechielEZ
DanielDAN
HozeášHOZ
JoelJOEL
ÁmosAM
ObadiášOB
JonášJON
MicheášMICH
NahumNAH
HabakukHAB
SofoniášSOF
HageusHAG
ZachariášZACH
MalachiášMAL
Nový Zákon (NZ)
KnihaFolder
MatúšMAT
MarekMAR
LukášLUK
JánJN
Skutky apoštolovSK
RimanomRIM
1. Korintským1KOR
2. Korintským2KOR
GalatskýmGAL
EfezanomEF
FilipskýmFIL
KolosanomKOL
1. Tesaloničanom1TES
2. Tesaloničanom2TES
KnihaFolder
1. Timoteovi1TIM
2. Timoteovi2TIM
TítusTIT
FilemonFILEM
ŽidomZID
JakubJAK
1. Petra1PET
2. Petra2PET
1. Jána1JAN
2. Jána2JAN
3. Jána3JAN
JúdaJUDA
Zjavenie JánaZJ
Ellen G. Whiteová (EGW)
Názov knihyFolder pre API
Cesta ku Kristoviegwcestakukristovi
Kristove podobenstváegwkristovepodobenstva
Myšlienky z hory blahoslavenstievegwmyslienkyzhoryblahoslavenstiev
Patriarchovia a prorociegwpatriarchoviaaproroci
Proroci a Králiegwprorociakrali
Skutky apoštolovegwskutkyapostolov
Túžba vekovegwtuzbavekov / egwtouhaveku
Veľký spor vekovegwvelkysporvekov / egwdramaveku
Na úsvitu dějinegwnausvitudejin

Chybové kódy

KódPopis
200OK - Požiadavka bola úspešne spracovaná.
401Unauthorized - Chýba API kľúč.
403Forbidden - Neplatný alebo zablokovaný kľúč.
404Not Found - Verš alebo kniha neexistuje.

Príklady integrácie

JavaScript (Fetch API)
async function loadVerse() {
    const apiKey = 'VAS_API_KLUC';
    const url = `https://casdzvolen.sk/kniznica/api/api_v1.php?action=fetch&folder=JN&ch=3&v=16&api_key=${apiKey}`;

    const response = await fetch(url);
    const data = await response.json();
    console.log(data.translations[0].text);
}
PHP (file_get_contents)
<?php
$api_url = "https://casdzvolen.sk/kniznica/api/api_v1.php?action=fetch&folder=1KOR&ch=13&v=13&api_key=VAS_KLUC";
$data = json_decode(file_get_contents($api_url), true);
echo $data['translations'][0]['text'];
?>