Servizi di condivisione

Genera e importa un calendario completo, dal 1583 al 2583 d.C., in formato .ics

Integra il Calendario Bizantino nei tuoi Servizi Web via API REST

Il sito offre un'**API (Application Programming Interface)** per ottenere le ricorrenze del calendario in formato **JSON**. Questa funzione consente l'integrazione dinamica con i servizi web e supporta richieste parametrizzate per personalizzare i dati restituiti.

Parametri supportati

• date: Specifica la data per cui ottenere le ricorrenze. Deve essere fornita come **timestamp UNIX**.
• format: Determina la struttura del JSON restituito.
  • Formato predefinito: Un array JSON con gli eventi del giorno ([]).
  • Formato oggetto: Forza la restituzione dei dati come oggetto JSON ({}). Utilizzare l'opzione &format=true.
• wrap: Se impostato su true, racchiude gli eventi restituiti all'interno di un oggetto con chiave events.

Caratteristiche principali

• Supporto per eventi di ciclo mobile e ciclo fisso.
• Restituisce dati strutturati in base ai requisiti specificati nella richiesta.

Esempi di utilizzo

Esempi di richieste supportate:

• Richiedi gli eventi per il 1° settembre 2024: ?op=ask&date=1725190075
• Forza il formato oggetto JSON: ?op=ask&format=true
• Racchiudi gli eventi in un oggetto con chiave events: ?op=ask&wrap=true

Output JSON

L'API restituisce i dati delle ricorrenze in formato JSON. Esempi:

• Formato predefinito (array JSON):

[
  {
      "title": "Circoncisione nella carne di nostro Signore Gesù Cristo",
      "description": "Poiché la Legge mosaica comandava che i figli maschi (...)",
      "date": {
          "date": "2025-01-01 00:00:00.000000",
          "timezone_type": 3,
          "timezone": "Europe/Rome"
      },
      "url": "https://www.calendariobizantino.it/Circoncisione_nella_carne_di_nostro_Signore_Gesù_Cristo-4.1735686000.0.html",
      "icon": "https://www.calendariobizantino.it/data/sections/calendario/icons/circoncisione.webp"
      },
      {
          "title": "San Basilio, il grande",
          "description": "San Basilio il Grande, figlio di Basilio del Ponto (...)",
          "date": {
              "date": "2025-01-01 00:00:00.000000",
              "timezone_type": 3,
              "timezone": "Europe/Rome"
          },
          "url": "https://www.calendariobizantino.it/San_Basilio,_il_grande-4.1735686000.1.html",
          "icon": "https://www.calendariobizantino.it/data/sections/calendario/icons/san_basilio_megas.webp"
          }
      ]

• Formato oggetto JSON (con format=true):

{
      "0": {
          "title": "Circoncisione nella carne di nostro Signore Gesù Cristo",
          "description": "Poiché la Legge mosaica comandava che i figli maschi (...)",
          "date": {
              "date": "2025-01-01 00:00:00.000000",
              "timezone_type": 3,
              "timezone": "Europe/Rome"
          },
          "url": "https://www.calendariobizantino.it/Circoncisione_nella_carne_di_nostro_Signore_Gesù_Cristo-4.1735686000.0.html",
          "icon": "https://www.calendariobizantino.it/data/sections/calendario/icons/circoncisione.webp"
      },
      "1": {
          "title": "San Basilio, il grande",
          "description": "San Basilio il Grande, figlio di Basilio del Ponto (...)",
          "date": {
              "date": "2025-01-01 00:00:00.000000",
              "timezone_type": 3,
              "timezone": "Europe/Rome"
          },
          "url": "https://www.calendariobizantino.it/San_Basilio,_il_grande-4.1735686000.1.html",
          "icon": "https://www.calendariobizantino.it/data/sections/calendario/icons/san_basilio_megas.webp"
      }
  }

• Formato con wrap=true:

{
      "events": {
          "0": {
              "title": "Circoncisione nella carne di nostro Signore Gesù Cristo",
              "description": "Poiché la Legge mosaica comandava che i figli maschi (...)",
              "date": {
                  "date": "2025-01-01 00:00:00.000000",
                  "timezone_type": 3,
                  "timezone": "Europe/Rome"
              },
              "url": "https://www.calendariobizantino.it/Circoncisione_nella_carne_di_nostro_Signore_Gesù_Cristo-4.1735686000.0.html",
              "icon": "https://www.calendariobizantino.it/data/sections/calendario/icons/circoncisione.webp"
          },
          "1": {
              "title": "San Basilio, il grande",
              "description": "San Basilio il Grande, figlio di Basilio del Ponto (...)",
              "date": {
                  "date": "2025-01-01 00:00:00.000000",
                  "timezone_type": 3,
                  "timezone": "Europe/Rome"
              },
              "url": "https://www.calendariobizantino.it/San_Basilio,_il_grande-4.1735686000.1.html",
              "icon": "https://www.calendariobizantino.it/data/sections/calendario/icons/san_basilio_megas.webp"
          }
      }
  }