Chargement du Playground
curl -X POST https://api.occultapi.com/api/astro/rashifal/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"2026-09-01","rashi":"aries","keys":["get_daily_rashifal","get_weekly_rashifal","get_monthly_rashifal"]}'Le Rashifal est la rubrique horoscope par signe : une prévision écrite pour toutes les personnes nées sous l’un des douze signes lunaires, sans thème natal. Cet endpoint en produit quatre — quotidienne, hebdomadaire, mensuelle et annuelle — chacune en anglais et en hindi dans la même réponse. L’astronomie sous-jacente est réelle et change selon l’échelle de temps. Les lectures quotidienne et hebdomadaire reposent sur le transit réel de la Lune dans les maisons comptées à partir de votre signe, ainsi que sur les stations réelles de Mercure, de Vénus ou de Mars qui tombent dans la semaine. La lecture mensuelle s’appuie sur la sankranti du Soleil, les stations de Mercure et de Vénus et les changements de signe de Mars au cours du mois ; l’annuelle, sur les transits de Jupiter, de Saturne et de Rahu-Ketu, plus un indicateur de Sade Sati simplifié, fondé sur le seul signe et tiré de la maison de Saturne par rapport à votre signe. Le texte qui habille ces événements, ainsi que la couleur et le nombre porte-bonheur, sont choisis parmi des ensembles rédigés à l’avance. Envoyez `rashi` sous forme de nom de signe et `date` au format `YYYY-MM-DD` ; la date est facultative et vaut par défaut la date du jour. La partie de la date utilisée dépend de la clé — la lecture hebdomadaire la prend comme premier jour de la semaine, la mensuelle n’en garde que le mois et l’année, et l’annuelle que l’année. Chaque champ texte a un jumeau `_hi` qui contient sa version hindi. Comme tout se joue au niveau du signe, traitez cet endpoint comme un flux de contenu plutôt que comme la lecture d’un thème. Pour une lecture personnalisée, calculez le thème et utilisez les endpoints de transit.
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| keys | array | obligatoire | Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels. |
| date | string (date) | facultatif | |
| rashi | string | facultatif | ariestaurusgeminicancerleovirgolibrascorpiosagittariuscapricornaquariuspiscesValidé dans le constructeur : une valeur invalide fait donc échouer toute la requête. |
Listez dans keys exactement les calculs voulus. Une clé inconnue fait rejeter toute la requête. Vous payez 1 crédit, quel que soit le nombre de clés demandées : regroupez-les donc.
| Clé | Champs supplémentaires requis | Description | |
|---|---|---|---|
| get_daily_rashifal | rashi | La prévision d’une journée pour un signe lunaire, fondée sur le transit réel de la Lune dans les maisons comptées à partir de ce signe. Renvoie un objet avec `date`, `sign`, `element`, un paragraphe `general_prediction`, un objet `aspects` qui associe trois ou quatre domaines de vie (famille, santé, voyages, carrière, etc.) à une phrase chacun, un objet `lucky` de la forme `{color, number, time}` et un objet `moon_transit` de la forme `{house, classification, benefic_support, malefic_pressure}`, où `classification` vaut favorable, neutral ou challenging. Chaque champ texte a un jumeau `_hi` qui contient la version hindi. | |
| get_monthly_rashifal | rashi | Une prévision pour un mois civil — seuls le mois et l’année de `date` sont utilisés, le jour est ignoré. Fondée sur la sankranti du Soleil, les stations de Mercure et de Vénus et les changements de signe de Mars au cours du mois. Renvoie `month`, `year`, `sign`, un paragraphe `overview`, les objets `planetary_transits` et `aspects`, `special_days` associant jusqu’à cinq dates favorables à une raison, et `remedies` sous forme de liste de deux suggestions. Chacun a un jumeau `_hi`. | |
| get_weekly_rashifal | rashi | Une prévision sur sept jours à partir de `date` : pour chacun des sept jours, le transit réel de la Lune est calculé, et toute station réelle de Mercure, de Vénus ou de Mars pendant la semaine est signalée. Renvoie `week_start`, `week_end`, `sign`, `element`, un paragraphe `overview`, un objet `aspects` indexé par "Weekday (date)" avec une phrase pour chacun des sept jours, `best_days` et `challenging_days` sous forme de listes de dates, `planetary_alerts` sous forme de liste d’alertes de station, et `lucky` au format `{color, number}`. Chacun a un jumeau `_hi`. | |
| get_yearly_rashifal | rashi | Une prévision pour une année civile — seule l’année de `date` est utilisée. Fondée sur les transits de Jupiter, de Saturne et de Rahu-Ketu, plus un indicateur de Sade Sati et d’Ashtama Shani fondé sur le seul signe et tiré de la maison de Saturne par rapport au signe (12e, 1re ou 2e pour la Sade Sati, 4e ou 8e pour Ashtama et Kantaka). Renvoie `year`, `sign`, un paragraphe `overview`, `planetary_movements`, un `quarterly_forecast` découpé en quatre parties, `yearly_aspects`, `lucky_elements` et `remedies`. Chaque champ texte a un jumeau `_hi`. Comme il s’agit d’une approximation au niveau du signe et non d’une lecture du thème natal, l’indicateur de Sade Sati est ici moins précis que celui de `/api/astro/shani_analysis/`. |