Documentație API
Interfața de Programare a Aplicației (Application Programming Interface)
Documentația API-ului site-ului www.cantaricrestine.ro
Pentru securitate trebuie să puneți in url parametru token cu o valoare aleatorie:
- Exemplu: token=5918234838
Pentru mai multe detalii vă rugăm să ne contactați folosind email-ul: admin@cantaricrestine.ro. Vă mulțumim!
Versetul zilei
Acolo nu va mai fi noapte. Şi nu vor mai avea trebuinţă nici de lampă, nici de lumina soarelui, pentru că Domnul Dumnezeu îi va lumina. Şi vor împărăţi în vecii vecilor. Apocalipsa 22:5
API-ul afișează un rezultat în format JSON
Tabel cu parametrii acceptați
Parametru Tip Exemplu token int/string 2840191902 (parametru oblicatoriu) id int/string 222 sau 123,222,334 categorie string c sau cr,cn,d limita int 2 (implicit este 10) sort string ASC sau DESC (implicit este ASC)
Lista cu parametrii categoriilor
- Diverse = d
- Cantarile Evangheliei (Carte Rosie) = cr
- Tineret = t
- Colinde = co
- Copii = c
- An nou = an
- Nunta = nu
- Cina = ci
- Pasti = p
- Cantarile Evangheliei (Carte Neagra) = cn
- Cantarile Evangheliei (Carte Albastra) = ca
- Imnuri Crestine (AZSMR) = ic
- Imnuri Crestine = ic2
- Pe drumul credintei = pdc
- Laudele Domnului = ld
- Imnurile Harului = ih
- Laudati pe Domnul = lpd
- Cantecele Bucuriei = cb
- Laudati pe Domnul (Groza) = lpdag
- Carte de cantari = cc
Elementele unui rezultat a API-ului sunt următoarele:
- id
- denumire
- descriere
- data_adaugare
- url_fisier
- url
- nr_descarcari
- nr_vizualizari
- categoria_simbol
- categoria
- img_coperta_categorie
Exemple:
Atentie! Nu există o ordine a parametrilor
Ex1: - afișare doar 3 cântări
https://www.cantaricrestine.ro/api.php?token=123&id=755,789,5
Ex2: - afișare cu limită de 3 cântări și sortare descrescătoare
https://www.cantaricrestine.ro/api.php?token=123&limita=3&sort=desc&id=755,789,5,45
Ex3: - afișare cântări din categoria Diverse -> d
https://www.cantaricrestine.ro/api.php?token=123&categorie=d
Ex4: - afișare cântări din categoria Diverse -> d cu limita de afișare de 50 cântări
https://www.cantaricrestine.ro/api.php?token=123&categorie=d&limita=50