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

Balayage des karanas

Un karana est une demi-tithi — six degrés d’écart entre la Lune et le Soleil, soit environ onze à treize heures. Il existe onze noms : sept mobiles, qui reviennent chacun huit fois au cours d’un mois lunaire, et quatre fixes, qui n’apparaissent qu’une fois chacun. Vishti, généralement appelé Bhadra, est celui qu’on évite. Cet endpoint trouve toutes les occurrences d’un karana donné sur une année civile entière : vous pouvez ainsi construire une liste « quand tombe le prochain Vishti » sans parcourir l’année jour par jour. Passez karana_name exactement comme il est écrit dans la liste du champ (sensible à la casse), year et timezone_as_float ; le décalage détermine le début et la fin de l’année locale. Ni latitude ni longitude ne sont nécessaires, car un karana est une grandeur purement lunaire. La réponse est {year, karana_name, rows}, où rows est une liste chronologique d’horodatages {start, end} en UTC. Un karana fixe donne environ douze lignes par an, un karana mobile près d’une centaine. Pour les karanas d’une seule journée, utilisez plutôt la clé karana_segments de /api/astro/panchanga/.

https://api.occultapi.com/api/astro/karana_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

karana_name

string

Champ	Type	Obligatoire	Remarques
karana_name	string	obligatoire	`KimstughnaBavaBalavaKaulavaTaitulaGarajaVanijaVishtiShakuniChatushpadaNaga`
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

obligatoire

KimstughnaBavaBalavaKaulavaTaitulaGarajaVanijaVishtiShakuniChatushpadaNaga

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

Exemple de requête

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

Réponse

{
  "data": {
    "year": 2026,
    "karana_name": "Kimstughna",
    "rows": [
      {
        "start": "2026-01-18T19:52:39+00:00",
        "end": "2026-01-19T08:22:04+00:00"
      },
      {
        "start": "2026-02-17T12:01:47+00:00",
        "end": "2026-02-17T23:48:42+00:00"
      },
      {
        "start": "2026-03-19T01:24:05+00:00",
        "end": "2026-03-19T12:26:49+00:00"
      },
      {
        "start": "2026-04-17T11:52:21+00:00",
        "end": "2026-04-17T22:18:56+00:00"
      },
      {
        "start": "2026-05-16T20:01:32+00:00",
        "end": "2026-05-17T06:07:05+00:00"
      },
      {
        "start": "2026-06-15T02:54:39+00:00",
        "end": "2026-06-15T12:57:08+00:00"
      },
      {
        "start": "2026-07-14T09:44:04+00:00",
        "end": "2026-07-14T20:00:36+00:00"
      },
      {
        "start": "2026-08-12T17:37:11+00:00",
        "end": "2026-08-13T04:21:33+00:00"
      },
      {
        "start": "2026-09-11T03:27:28+00:00",
        "end": "2026-09-11T14:48:43+00:00"
      },
      {
        "start": "2026-10-10T15:50:36+00:00",
        "end": "2026-10-11T03:52:40+00:00"
      },
      {
        "start": "2026-11-09T07:02:42+00:00",
        "end": "2026-11-09T19:43:50+00:00"
      },
      {
        "start": "2026-12-09T00:52:31+00:00",
        "end": "2026-12-09T14:03:05+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.