Initium celeris API Gianna

API /liturgy/v1 aditus ad solam lectionem datorum liturgicorum catholicorum est: calendarium, propria Missae, Officium et sancti per ritus Romanum ordinarium, Romanum anni 1962 (TLM) et Dominicanum. Gratuitum est cum ratione Gianna. Ad exemplum datorum integrum vide Liturgiam; haec pagina petitiones incipere sinit.

1. Crea clavem

Crea clavem in applicatione sub Optiones, Aditus programmatoris. Clavis semel ostenditur et iterum recipi non potest. Etiam ex sessione interretiali quae accessit creare potes cum crustulo tuo gianna_session:

curl -s https://gianna.chat/api/keys \
  -H 'Content-Type: application/json' \
  -b 'gianna_session=YOUR_SESSION_COOKIE' \
  -d '{"name":"my-script"}'
# → { "id": "...", "name": "my-script", "key": "gianna_…" }

Serva valorem gianna_…. Quaeque petitio datorum eum ut tesseram baiulam praebet: Authorization: Bearer gianna_…. Data liturgiae et ecclesiarum sola ratione indigent. Petitiones familiae subscriptione activa vel probatoria indigent; actio in familia cuius subscriptio exspiravit 403 accipit.

Personae, instituta et officia etiam per /registry/v1/people, /registry/v1/sees et /registry/v1/offices praesto sunt. Eorum documentum OpenAPI campos et subsidia conexa describit. Lectiones reference:read requirunt. Curatores et administratores has tabulas addere et emendare possunt cum clave rationi conexa quae household:write habet; opus referentiae eorum subscriptionem solutam non requirit. Vide Personas et officia curare ad emendationes et importationes.

2. Dies liturgicus

curl -s https://gianna.chat/liturgy/v1/calendars/ordinary/days/2026-12-25 \
  -H 'Authorization: Bearer gianna_…'

Via est /calendars/{cal}/days/{date}, ubi cal est ordinary, traditional vel dominican, et date est ISO YYYY-MM-DD. Latina semper adest; adde Accept-Language: en ut etiam textum Anglicum accipias.

3. Quaere sanctos

curl -s 'https://gianna.chat/liturgy/v1/saints?q=peter&title=martyr' \
  -H 'Authorization: Bearer gianna_…'

Inventa in involucro collectionis (results, query, page) veniunt; praebe ?page=N ad paginas percurrendas.

4. Orationes et Scriptura

curl -s https://gianna.chat/liturgy/v1/prayers/hail-mary -H 'Authorization: Bearer gianna_…'
curl -s 'https://gianna.chat/liturgy/v1/scripture?ref=Jn%203:16&editions=douay' \
  -H 'Authorization: Bearer gianna_…'

Textus exacte ut publicatus cum fonte redit.

5. Tempora Missae et Confessionis

curl -s 'https://gianna.chat/directory/v1/churches?near=Cambridge' -H 'Authorization: Bearer gianna_…'
curl -s 'https://gianna.chat/directory/v1/churches?q=Our%20Lady&locality=Cambridge' \
  -H 'Authorization: Bearer gianna_…'

Quodque tempus servitii source_url, scraped_at et confidence habet. Quaestio nominis ecclesiae quam Gianna nondum novit status: "checking" reddit et fontes quaerere incipit; postea iterum tempta. Clavis directory:read requirit.

6. Familia tua

Cum household:read (et household:write ad mutationes):

curl -s https://gianna.chat/household/v1/tasks -H 'Authorization: Bearer gianna_…'
curl -s https://gianna.chat/household/v1/reminders -H 'Authorization: Bearer gianna_…' \
  -H 'Content-Type: application/json' -H 'Idempotency-Key: 4f1c…' \
  -d '{"body":"Pray the Angelus","at":"2026-12-24T12:00:00Z","recurrence":{"unit":"daily"}}'

Gianna ipsa monitiones tradit. Mitte Idempotency-Key cum omni POST ne repetitio secundam monitionem creet; eadem clavis et corpus primum responsum per 24 horas repetunt. Mutationes statim in applicatione apparent.

Editionem Scripturae eligere

Textus lectionis per se editione iuris publici cuiusque linguae utitur. Ad unam eligendam, praebe ?editions=<id>[,<id>] (≤1 pro lingua). Identificatores praesentes: vulgate (la), douay (en), cpdv (en); series viva apud /liturgy/v1/translations est. Identificatores ignoti ad valorem praestitutum redeunt, leniter cum monitione collectionis. Electio resoluta ut editions in responso repetitur. translations nomen alternum acceptum est; editions praevalet si utrumque mittitur.

curl -s 'https://gianna.chat/liturgy/v1/calendars/ordinary/days/2026-12-25?editions=douay' \
  -H 'Authorization: Bearer gianna_…'

Limites frequentiae

Petitiones pro familia in intervallo fixo unius minuti limitantur. Ultra limitem accipis 429 Too Many Requests cum titulo Retry-After (secunda usque ad intervalli renovationem) et corpore application/problem+json. Exspecta illa secunda et iterum tempta.

Pactum integrum

Quaeque familia documentum publicum OpenAPI 3.1 cum operationIds publicat: /liturgy/v1/openapi.json, /directory/v1/openapi.json et /household/v1/openapi.json. /.well-known/api-catalog omnia enumerat. Errores sunt application/problem+json.

Fontes calendarii

Fontes dierum festorum clave non indigent. Subscribe ex qualibet applicatione calendarii:

https://gianna.chat/liturgy/v1/calendars/ordinary/feasts.ics?rank=feast&region=general

Vide Calendaria festorum catholicorum ad nexus unius pressus.