GET /v2/times/today.json

Ritorni di oggi tempi di preghiera basati su data la zona.

URL della risorsa

https://api.pray.zone/v2/times/today.json

Parametri

{format}typeoptionaldecription
{city}stringObbligatorioL'id della città è il nome della città, lo spazio viene sostituito con "-". L'elenco delle città e l'ID sono accessibili qui.
Obbligatorio se {Longitudine} | { Latitudine} | {elevazione} o {ip} mancante.
https://api.pray.zone/v2/times/today.json?city=mecca
{longitude}
{latitude}
{elevation}
stringObbligatorio

Obbligatorio se {Longitudine} | { Latitudine} | {elevazione} o {città} mancante.
https://api.pray.zone/v2/times/today.json?longitude=39.81666564941406&latitude=21.416667938232425&elevation=333

longitudeLongitudine deve essere compreso tra -180 e 180 gradi inclusive
latitudeLongitudine deve essere compreso tra -90 e 90 gradi inclusive
elevationAltezza deve essere compresa tra -2000 e 8000 metri incluso
{ip}stringObbligatorioSono ammessi solo IPv4
Obbligatorio se {città} o {ip} è mancante.
https://api.pray.zone/v2/times/today.json?ip=163.172.18.192
{key}stringopzionaleUtilizziamo una chiave per evitare abusi sulla nostra API. L'API è gratuita!
https://api.pray.zone/v2/times/today.json?city=mecca&key=MagicKey
{school}intopzionale

Ogni paese ha una scuola assegnata di default, l'elenco delle scuole per paese è accessibile qui.
https://api.pray.zone/v2/times/today.json?city=mecca&school=2

IdNomeFejrIcha
0Ithna Ashari1614
1Università di scienze islamiche, Karachi1818
2Islamic Society of North America1515
3Lega musulmana mondiale1817
4Umm Al-Qura University, la Mecca18,590
5Autorità generale egiziano della Survey1818
7Istituto di geofisica, Università di Teheran17,714
8Marocco1918
9Dipartimento di avanzamento islamico, Malaysia (JAKIM)2018
10Majlis Ugama Islam Singapura2018
11Unione delle organizzazioni Islamiques de France1212
12Turchia1212
{juristic}intopzionale

0 per Shafii (o il modo standard), 1 per Hanafi. Se lo lasci vuoto, il valore predefinito è Shafii.
https://api.pray.zone/v2/times/today.json?city=mecca&juristic=1

IdGiuridiche
0Shafii (predefinito)
1Hanafi
{highlat}intopzionale

In luoghi a latitudine più elevata, il crepuscolo può persistere durante la notte durante alcuni mesi dell'anno. In questi periodi anormali, la determinazione di Fajr e Isha non è possibile usando le solite formule menzionate nella sezione precedente. Per superare questo problema sono state proposte diverse soluzioni, tre delle quali sono descritte di seguito.
https://api.pray.zone/v2/times/today.json?city=mecca&highlat=2

School nameSchool idDescription
None (predefinito)0Nessuna regolazione
Mezzanotte1Il periodo dal tramonto all'alba è diviso in due parti. Il primo semestre è considerato la "notte" e l'altra metà "l'intervallo". Fajr e Isha in questo metodo si presume siano a mezzanotte durante i periodi anormali.
Un settimo della notte2Il periodo tra il tramonto e l'alba è diviso in sette parti. Isha inizia dopo la prima settima parte e Fajr è all'inizio della settima parte.
Basato sull'angolo3Questa è una soluzione intermedia, utilizzata da alcuni calcolatori del tempo di preghiera recenti. Sia un angolo crepuscolare per Isha, e sia t = a / 60. Il periodo tra il tramonto e l'alba è diviso in parti. Isha inizia dopo la prima parte. Ad esempio, se l'angolo del crepuscolo per Isha è 15, Isha inizia alla fine del primo quarto (15/60) della notte. Il tempo per Fajr è calcolato in modo simile.
{timeformat}intopzionale

Formato orario
https://api.pray.zone/v2/times/today.json?city=mecca&timeformat=1

Formato orarioTempo IDExample:
Formato di 24 ore (predefinito)009:00, 15:45, 22:12
Formato di 12 ore109:00 am, 03:45 pm, 10:12 pm
Formato di 12 ore senza suffisso209:00, 03:45, 10:12

Parametri

{format}typeoptionaldecription
{key}stringNoUtilizziamo una chiave per evitare abusi sulla nostra API. L'API è gratuita!
{city}stringNoL'id della città è il nome della città, lo spazio viene sostituito con "-". L'elenco delle città e l'ID sono accessibili qui.
{school}int

Ogni paese ha una scuola assegnata di default, l'elenco delle scuole per paese è accessibile qui.

IdNomeFejrIcha
0Ithna Ashari1614
1Università di scienze islamiche, Karachi1818
2Islamic Society of North America1515
3Lega musulmana mondiale1817
4Umm Al-Qura University, la Mecca18,590
5Autorità generale egiziano della Survey1818
7Istituto di geofisica, Università di Teheran17,714
8Marocco1918
9Dipartimento di avanzamento islamico, Malaysia (JAKIM)2018
10Majlis Ugama Islam Singapura2018
11Unione delle organizzazioni Islamiques de France1212
12Turchia1212
{juristic}int

0 per Shafii (o il modo standard), 1 per Hanafi. Se lo lasci vuoto, il valore predefinito è Shafii.

IdGiuridiche
0Shafii (default)
1Hanafi
{higher-latitudes}int

In luoghi a latitudine più elevata, il crepuscolo può persistere durante la notte durante alcuni mesi dell'anno. In questi periodi anormali, la determinazione di Fajr e Isha non è possibile usando le solite formule menzionate nella sezione precedente. Per superare questo problema sono state proposte diverse soluzioni, tre delle quali sono descritte di seguito.

School nameSchool idDescription
None (predefinito)0Nessuna regolazione
Mezzanotte1Il periodo dal tramonto all'alba è diviso in due parti. Il primo semestre è considerato la "notte" e l'altra metà "l'intervallo". Fajr e Isha in questo metodo si presume siano a mezzanotte durante i periodi anormali.
Un settimo della notte2Il periodo tra il tramonto e l'alba è diviso in sette parti. Isha inizia dopo la prima settima parte e Fajr è all'inizio della settima parte.
Basato sull'angolo3Questa è una soluzione intermedia, utilizzata da alcuni calcolatori del tempo di preghiera recenti. Sia un angolo crepuscolare per Isha, e sia t = a / 60. Il periodo tra il tramonto e l'alba è diviso in parti. Isha inizia dopo la prima parte. Ad esempio, se l'angolo del crepuscolo per Isha è 15, Isha inizia alla fine del primo quarto (15/60) della notte. Il tempo per Fajr è calcolato in modo simile.
{time-format}int

Formato orario

Formato orarioTempo IDExample:
Formato di 24 ore (predefinito)009:00, 15:45, 22:12
Formato di 12 ore109:00 am, 03:45 pm, 10:12 pm
Formato di 12 ore senza suffisso209:00, 03:45, 10:12
{day}stringUtilizziamo una chiave per evitare abusi sulla nostra API. L'API è gratuita!
{month-year}stringUtilizziamo una chiave per evitare abusi sulla nostra API. L'API è gratuita!

Example Request

https://api.pray.zone/v2/times/today.json?city=paris

Example Result

{
  "code": 200,
  "status": "OK",
  "results": {
    "datetime": [
      {
        "times": {
          "Imsak": "06:52",
          "Sunrise": "08:16",
          "Fajr": "07:02",
          "Dhuhr": "12:38",
          "Asr": "14:39",
          "Sunset": "17:00",
          "Maghrib": "17:21",
          "Isha": "18:14",
          "Midnight": "00:01"
        },
        "date": {
          "timestamp": 1606435200,
          "gregorian": "2020-11-27",
          "hijri": "1442-04-12"
        }
      }
    ],
    "location": {
      "latitude": 48.856613159179688,
      "longitude": 2.3522219657897949,
      "elevation": 36.0,
      "city": "Paris",
      "country": "France",
      "country_code": "FR",
      "timezone": "Europe/Paris",
      "local_offset": 1.0
    },
    "settings": {
      "timeformat": "HH:mm",
      "school": "Ithna Ashari",
      "juristic": "Shafii",
      "highlat": "None",
      "fajr_angle": 12.0,
      "isha_angle": 12.0
    }
  }
}