POST/api/astro/yoga_scan/1 crédit

Balayage annuel d’un Nitya Yoga

Le Nitya Yoga est l’une des vingt-sept divisions du cercle obtenu en additionnant les longitudes sidérales du Soleil et de la Lune. Chacun des vingt-sept — de Vishkambha à Vaidhriti — dure un peu moins d’un jour, et ils comptent en astrologie élective : Vyatipata, Vaidhriti, Parigha, Vyaghata, Shoola, Ganda et Atiganda sont traditionnellement évités, tandis que les yogas Siddhi, Siddha, Shubha, de la classe Amrita et Sukarma sont recherchés. Cet endpoint prend un yoga par son nom et renvoie toutes ses occurrences sur une année civile. `yoga_name` est sensible à la casse et doit correspondre exactement à l’énumération. `year` et `timezone_as_float` définissent l’année locale à couvrir ; aucune coordonnée n’est nécessaire, car le yoga change au même instant partout. Comme la somme des deux longitudes avance d’environ 13 degrés 20 minutes toutes les 22.6 heures, chaque yoga revient environ quatorze ou quinze fois par an. La réponse est `{year, yoga_name, rows}`, où `rows` est une liste chronologique d’horodatages ISO UTC `{start, end}`. Chaque paire donne les instants réels de début et de fin du yoga, trouvés par dichotomie sur la somme des longitudes du Soleil et de la Lune, et non par échantillonnage au lever du soleil : les limites sont donc précises à une fraction de seconde près.

https://api.occultapi.com/api/astro/yoga_scan/

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Champs de la requête

Champ Type Obligatoire Remarques

timezone_as_float

number (double)

Champ	Type	Obligatoire	Remarques
timezone_as_float	number (double)	obligatoire	Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été.
year	integer	obligatoire	Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres. min 1800 · max 2400
yoga_name	string	obligatoire	`VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva`

obligatoire

Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été.

year

integer

obligatoire

Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres.

min 1800 · max 2400

yoga_name

string

obligatoire

VishkambhaPreetiAyushmanSaubhagyaShobhanaAtigandaSukarmaDhritiShoolaGandaVriddhiDhruva

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/yoga_scan/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"timezone_as_float":5.5,"year":2026,"yoga_name":"Vishkambha"}'

Réponse

{
  "data": {
    "year": 2026,
    "yoga_name": "Vishkambha",
    "rows": [
      {
        "start": "2026-01-04T20:17:27.999999+00:00",
        "end": "2026-01-05T17:17:16.999999+00:00"
      },
      {
        "start": "2026-01-30T11:28:35.999999+00:00",
        "end": "2026-01-31T08:03:35.999999+00:00"
      },
      {
        "start": "2026-02-24T22:56:20.999999+00:00",
        "end": "2026-02-25T19:58:43.999999+00:00"
      },
      {
        "start": "2026-03-22T10:11:35.999999+00:00",
        "end": "2026-03-23T06:52:06.999999+00:00"
      },
      {
        "start": "2026-04-17T01:51:55.999999+00:00",
        "end": "2026-04-17T22:15:28.999999+00:00"
      },
      {
        "start": "2026-05-12T17:49:31.999999+00:00",
        "end": "2026-05-13T15:24:49.999999+00:00"
      },
      {
        "start": "2026-06-07T04:31:57.999999+00:00",
        "end": "2026-06-08T03:58:13.999999+00:00"
      },
      {
        "start": "2026-07-02T11:09:21.999999+00:00",
        "end": "2026-07-03T11:30:01.999999+00:00"
      },
      {
        "start": "2026-07-27T17:24:55.999999+00:00",
        "end": "2026-07-28T18:03:37.999999+00:00"
      },
      {
        "start": "2026-08-21T23:48:40.999999+00:00",
        "end": "2026-08-23T00:44:33.999999+00:00"
      },
      {
        "start": "2026-09-16T06:52:40.999999+00:00",
        "end": "2026-09-17T07:19:46.999999+00:00"
      },
      {
        "start": "2026-10-11T15:35:35.999999+00:00",
        "end": "2026-10-12T15:02:25.999999+00:00"
      },
      {
        "start": "2026-11-05T23:39:40.999999+00:00",
        "end": "2026-11-06T22:40:11.999999+00:00"
      },
      {
        "start": "2026-12-01T06:45:12.999999+00:00",
        "end": "2026-12-02T05:01:50.999999+00:00"
      },
      {
        "start": "2026-12-26T18:52:33.999999+00:00",
        "end": "2026-12-27T15:23:47.999999+00:00"
      }
    ]
  },
  "message": "successful",
  "is_error": false
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.