Santo del giorno
Santo del Giorno
Un progetto di software libero per avere API semplici e complete per ottenere il santo del giorno.
Le chiamate alle API possono essere integrate in qualunque progetto (anche commerciale) in modo completamente gratuito. La registrazione è necessaria per consentire il monitoraggio degli accessi e la gestione della sicurezza
Il progetto prevede l'importazione di più fonti dati. Al momento, anche per motivi di copyright, i dati vengono presi esclusivamente da Cathopedia la Wikipedia Cattolica

Documentazione

Versione WEB

L'utilizzo della versione WEB è molto semplice: basta selezionare la tipologia di ricerca (per data o per nome) ed effettuare la ricerca

API

Molto più interessante è la possibilità di richiamare il servizio via API.

Per fare questo è necessario registrarsi e confermare la propria mail. La registrazione è assolutamente gratuita e l'indirizzo email non verrà MAI ceduto a nessuno.

Tutte le chiamate alle API devono essere autenticate usando un Beaer token ottenuto nella propria area personale, alla voce Profilo, oppure chiamando l'API login

curl --location 'https://santodelgiorno.mintdev.me/api/login' \
--form 'email="user@example.com"' \
--form 'password="password"'

Elenco Santi

Elenco paginato tutti i santi inseriti

GET https://santodelgiorno.mintdev.me/api/v1/santo
Accept: application/json
Authorization: Bearer <token>

Informazione su singolo santo

GET https://santodelgiorno.mintdev.me/api/v1/santo/<uuid>
Accept: application/json
Authorization: Bearer <token>

Per avere il dettaglio della fonte:

GET https://santodelgiorno.mintdev.me/api/v1/santo/<uuid>?include=fonte
Accept: application/json
Authorization: Bearer <token>

Ricerca

Ricerca per data

GET https://santodelgiorno.mintdev.me/api/v1/santo/data/{mese}/{giorno}
Accept: application/json
Authorization: Bearer <token>
  • mese: numero intero tra 1 e 12
  • giorno: numero intero tra 1 e 31

Ricerca per nome

GET https://santodelgiorno.mintdev.me/api/v1/santo/nome/{nome}
Accept: application/json
Authorization: Bearer <token>

La ricerca avviene in modo case-insensitive e in LIKE

Ricerca onomastico

GET https://santodelgiorno.mintdev.me/api/v1/santo/onomastico/{nome}
Accept: application/json
Authorization: Bearer <token>

La ricerca avviene in modo case-insensitive e in LIKE. Torna gli onomastici primari e secondari