Documentație API

Interfața de Programare a Aplicației (Application Programming Interface) pentru site-ul cantaricrestine.ro

Contact: admin@cantaricrestine.ro

Versetul zilei

Domnul să vă îndrepte inimile spre dragostea lui Dumnezeu şi spre răbdarea lui Hristos!

2 Tesaloniceni 3:5

resursecrestine.ro

Pentru securitate trebuie să puneți în URL parametrul token cu o valoare aleatorie. Exemplu: token=2235107879

Parametri acceptați

Parametru	Tip	Exemplu
`token`	int/string	3565371159 (obligatoriu)
`id`	int/string	222 sau 123,222,334
`categorie`	string	c sau cr,cn,d
`limita`	int	2 (implicit 10)
`pagina`	int	2 (implicit 1)
`sort`	string	ASC sau DESC (implicit ASC)

Coduri categorii

Categorie	Cod
Diverse	`d`
Cântările Evangheliei (Carte Roșie)	`cr`
Tineret	`t`
Colinde	`co`
Copii	`c`
An nou	`an`
Nuntă	`nu`
Cina	`ci`
Paști	`p`
Cântările Evangheliei (Carte Neagră)	`cn`
Cântările Evangheliei (Carte Albastră)	`ca`
Imnuri Creștine (AZSMR)	`ic`
Imnuri Creștine	`ic2`
Pe drumul credinței	`pdc`
Laudele Domnului	`ld`
Imnurile Harului	`ih`
Lăudați pe Domnul	`lpd`
Cântecele Bucuriei	`cb`
Lăudați pe Domnul (Groza)	`lpdag`
Carte de cântări	`cc`

Câmpuri rezultat API

Câmp	Descriere
Paginație
`paginatie.total_rezultate`	Numărul total de rezultate
`paginatie.pagina_curenta`	Pagina curentă
`paginatie.total_pagini`	Numărul total de pagini
`paginatie.limita`	Rezultate per pagină
Rezultate (per cântare)
`id`	ID-ul cântării
`denumire`	Numele cântării
`descriere`	Descrierea / textul cântării
`data_adaugare`	Data adăugării
`url_fisier`	URL-ul fișierului PowerPoint
`url`	URL-ul paginii cântării
`nr_descarcari`	Numărul de descărcări
`nr_vizualizari`	Numărul de vizualizări
`categoria_simbol`	Codul categoriei
`categoria`	Numele categoriei
`img_coperta_categorie`	Imaginea copertei categoriei

Exemple de utilizare

Ex1: Afișare doar 3 cântări după ID

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

https://www.cantaricrestine.ro/api.php?token=123&categorie=d

Ex4: Afișare 50 cântări din categoria Diverse

https://www.cantaricrestine.ro/api.php?token=123&categorie=d&limita=50

Ex5: Pagina 2 cu 50 cântări per pagină din categoria Diverse

https://www.cantaricrestine.ro/api.php?token=123&categorie=d&limita=50&pagina=2

Exemplu rezultat JSON

{
  "paginatie": {
    "total_rezultate": 230,
    "pagina_curenta": 1,
    "total_pagini": 5,
    "limita": 50
  },
  "rezultate": {
  "755": {
    "id": "755",
    "denumire": "001 Lui Dumnezeu sa-I canti",
    "descriere": "Lui Dumnezeu să-I cânți\nO, suflete al meu...",
    "data_adaugare": "2019-03-15 10:30:00",
    "url_fisier": "https://www.cantaricrestine.ro/cantari/lpd/001-lui-dumnezeu-sa-i-canti.pptx",
    "url": "https://www.cantaricrestine.ro/001-lui-dumnezeu-sa-i-canti",
    "nr_descarcari": "342",
    "nr_vizualizari": "1580",
    "categoria_simbol": "lpd",
    "categoria": "Laudati pe Domnul",
    "img_coperta_categorie": "https://www.cantaricrestine.ro/imagini/lpd.jpg"
  },
  "789": {
    "id": "789",
    "denumire": "035 Cine-i omul care vrea",
    "descriere": "",
    "data_adaugare": "2019-04-22 08:15:00",
    "url_fisier": "https://www.cantaricrestine.ro/cantari/cr/035-cine-i-omul-care-vrea.pptx",
    "url": "https://www.cantaricrestine.ro/035-cine-i-omul-care-vrea",
    "nr_descarcari": "128",
    "nr_vizualizari": "654",
    "categoria_simbol": "cr",
    "categoria": "Cantarile Evangheliei",
    "img_coperta_categorie": "https://www.cantaricrestine.ro/imagini/cr.jpg"
  }
  }
}

Tematic

Carte