Journal des modifications

Mudda dasha

Mudda dasha est désormais correctement orthographié et se trouve à /api/astro/mudda-dasha/, à côté de Muntha dans la section Tajika et varshaphala. L’ancien /api/astro/muddha_dasha/ est retiré ; le nouvel endpoint renvoie les maîtres par leur nom et chaque début sous forme d’horodatage ISO, au lieu de numéros de planètes et d’une chaîne de date contenant un dictionnaire de degrés.

• POST /api/astro/mudda-dasha/

Ce qui remplace quoi

Aspects tajika : utilisez /api/astro/tajika/aspects/ au lieu de /api/astro/tajaka/. Yogas tajika : /api/astro/tajika/yogas/ au lieu de /api/astro/tajaka_yoga/. Sahams : /api/astro/sahams/ au lieu de /api/astro/saham/. Prashnavali : les quatre endpoints /api/astro/prashnavali/ au lieu de /api/astro/chakra/. Gun milan : /api/astro/ashtakoota/ avec la clé `compatibility_score`, qui renvoie les mêmes treize valeurs (les huit scores des kootas, le total sur 36 et les quatre vérifications sud-indiennes), au lieu de /api/astro/gun-milan/. Shadbala : /api/astro/strength/ au lieu de /api/astro/shadbala/. Dashas de nakshatra et de rashi : /api/astro/dasha/nakshatra/ et /api/astro/dasha/rashi/ au lieu de /api/nakshatra_dasha/ et /api/raasi_dasha/. Éclipses : les sept endpoints nommés sous /api/astro/eclipse/ au lieu de l’endpoint brut /api/astro/eclipse/. KP : /api/astro/kp-chart/ au lieu de /api/astro/krishnamurti/.

Si vous appelez un endpoint retiré

Avec une clé API, un appel à l’un de ces endpoints renvoie désormais 403 endpoint_not_allowed et ne consomme aucun crédit. Passez à l’endpoint de remplacement indiqué ci-dessus ; le SDK et la collection Postman l’utilisent déjà.

• POST /api/astro/muddha_dasha/
• POST /api/astro/tajaka/
• POST /api/astro/tajaka_yoga/
• POST /api/astro/saham/
• POST /api/astro/chakra/
• POST /api/astro/gun-milan/
• POST /api/astro/shadbala/
• POST /api/nakshatra_dasha/
• POST /api/raasi_dasha/
• POST /api/astro/eclipse/
• POST /api/astro/krishnamurti/

Ce qui change

La liste des célébrités et la consultation d’une célébrité donnée ne sont plus proposées. Avec une clé API, un appel à l’un ou l’autre renvoie 403 endpoint_not_allowed et ne consomme aucun crédit. Tous les autres endpoints sont inchangés. Si vous avez conservé des données de naissance issues de ces endpoints, vous pouvez toujours les envoyer aux endpoints de thème, comme n’importe quelles autres données de naissance.

• GET /api/astro-data/celebrities/
• GET /api/astro-data/celebrities/{id}/

Jamakkol Prashna

Envoyez l’heure locale de la question, avec le lieu et son décalage UTC. Vous obtenez les huit jama grahas, Udhayam, Arudam et Kavippu, le jamam du jour ou de la nuit, Kuligan, Emakandam, Mrithyu et Rahu Time, les planètes et le panchanga du moment. Passez arudam_sign quand le consultant choisit le signe ; omettez-le pour que l’Arudam soit tiré de l’heure. Vérifié par rapport à jamakkol.com sur plus de 20 thèmes ; pour obtenir exactement les résultats de ce site, envoyez l’ayanamsa true_citra avec le nœud moyen.

• POST /api/astro/prashna/jamakkol/

Ashtamangala Prashna

Envoyez l’instant et le lieu, le signe Arudha choisi par le consultant, et les cauris sous forme de trois tas ou du nombre à trois chiffres. Vous obtenez l’Arudha, le Chatra, les six rasis du Prasna Kriya avec l’organe que chacun gouverne, les cinq Sutras, les planètes comptées depuis le Lagna et depuis l’Arudha, et la lecture complète du nombre, chiffre par chiffre. Les sphutas ne sont pas repris ici : appelez /api/astro/prashna/ pour le même instant afin de les obtenir.

• POST /api/astro/prashna/ashtamangala/

Ce qui change

Chacun de ces endpoints partage son sérialiseur de requête avec /api/astro/panchanga/, le seul endpoint qui calcule réellement les cinquante clés et plus du panchang et qui a besoin de toutes les entrées réglables qu’elles utilisent à elles toutes. Les endpoints ciblés héritaient pourtant de toute cette liste de champs. Ainsi, /day-night-length/, simple calcul de lever et de coucher du soleil, documentait et acceptait gulika_rises_at, gulika_portion, mandi_rises_at, mandi_portion, kala_mrityu_rise_at et dhuma_vyatipata_relation (réglages des points d’ombre), samvata_type et mode (choix de l’ère et du mode de calcul), ainsi que mean_anomaly, eccentricity, eccentric_anomaly, tolerance et nakshatras — treize champs dont aucun n’est jamais lu par son propre calcul. Désormais, chaque endpoint ne documente et n’accepte que les champs que son propre calcul utilise réellement : /samvat/ conserve samvata_type, /lunar-month/ conserve mode, /upagraha/ conserve les six champs gulika/mandi/kala-mrityu/dhuma-vyatipata, et les 26 autres n’en conservent aucun des treize.

• POST /api/astro/panchang/
• POST /api/astro/rahu-kaal/
• POST /api/astro/choghadiya/
• POST /api/astro/hora/
• POST /api/astro/auspicious-timings/
• POST /api/astro/inauspicious-timings/
• POST /api/astro/vasa-segments/
• POST /api/astro/lunar-phase/
• POST /api/astro/day-night-length/
• POST /api/astro/sankranti/
• POST /api/astro/tithi/
• POST /api/astro/nakshatra/
• POST /api/astro/nitya-yoga/
• POST /api/astro/karana/
• POST /api/astro/abhijit-muhurat/
• POST /api/astro/brahma-muhurat/
• POST /api/astro/amrit-kaal/
• POST /api/astro/durmuhurat/
• POST /api/astro/disha-shool/
• POST /api/astro/muhurta-table/
• POST /api/astro/sandhya/
• POST /api/astro/panchak/
• POST /api/astro/samvat/
• POST /api/astro/lunar-month/
• POST /api/astro/tarabala/
• POST /api/astro/chandrabala/
• POST /api/astro/lagna/
• POST /api/astro/bhava-cusps/
• POST /api/astro/upagraha/

Pourquoi c’est important

Un champ présent sur la page de référence d’un endpoint affirme que le régler a un effet. Ce n’était pas le cas : gulika_rises_at envoyé à /day-night-length/ était toujours ignoré sans le moindre avertissement, ce qui est pire que l’absence du champ, car cela invite à passer du temps à ajuster un réglage qui ne peut jamais changer la réponse. Chaque page d’endpoint liste désormais exactement les paramètres qui influent sur le résultat de cet endpoint, rien de plus.

Rien ne casse

Le calcul de ces endpoints n’a jamais lu ces champs : les retirer de la documentation et du schéma ne modifie le comportement d’aucun endpoint. Si votre intégration envoie déjà l’un d’eux, par exemple à /day-night-length/, la requête réussit toujours et la réponse est inchangée — ce que nous avons vérifié avant la mise en production, par des appels avant/après appariés sur chaque endpoint concerné. La seule différence : la page de référence et les types générés du SDK ne proposent plus un réglage qui n’a jamais servi à rien.

Ce qui change

Quatorze blocs : Panchang, Rahu Kaal, Choghadiya, Abhijit et Brahma Muhurat, Durmuhurat, dates d’Ekadashi/Amavasya/Purnima/Pradosh/Sankashti Chaturthi, un calendrier des fêtes, Rashifal et un formulaire de kundli. Chacun est un vrai bloc de l’éditeur de blocs, à glisser depuis l’outil d’insertion comme n’importe quel bloc de base, avec un shortcode équivalent pour ceux qui utilisent encore l’éditeur classique.

Pourquoi c’est important

Un propriétaire de site qui n’a jamais écrit une ligne de PHP peut ajouter à son site un widget de panchang en direct, le temps de glisser un bloc et de coller une clé API. Le plugin n’est qu’une fine couche d’affichage au-dessus des endpoints décrits ailleurs dans ce journal : sans logique de calcul propre, il ne peut jamais contredire l’API.

Les seize shodasavargas ont tous leur route — 8 nouveaux

D1 rashi, D4 chaturthamsa, D16 shodasamsa, D20 vimsamsa, D24 chaturvimsamsa, D27 nakshatramsa, D40 khavedamsa et D45 akshavedamsa rejoignent les huit déjà publiés (D2, D3, D7, D9, D10, D12, D30, D60). RIEN DE NOUVEAU N’EST CALCULÉ : /api/astro/chart/ pouvait déjà produire ces cartes en passant chart_name, et ces routes délèguent à la même vue, si bien que les nombres sont identiques par construction. Ce qui change, c’est qu’on peut les trouver : une route nommée /navamsa/ se découvre, un chart_name enfoui dans un corps de requête, non. /api/astro/rashi/ est la même vue avec la carte fixée, et sa sortie est identique à l’octet près à celle de /api/astro/planet-positions/ — un test le vérifie précisément, pour que les deux ne puissent pas diverger.

• POST /api/astro/rashi/
• POST /api/astro/chaturthamsa/
• POST /api/astro/shodasamsa/
• POST /api/astro/vimsamsa/
• POST /api/astro/chaturvimsamsa/
• POST /api/astro/nakshatramsa/
• POST /api/astro/khavedamsa/
• POST /api/astro/akshavedamsa/

Quatre divisions hors shodasavarga — 4 nouveaux

D5 panchamsa (renommée et autorité), D6 shashthamsa (santé et ennemis), D8 ashtamsa (longévité et événements soudains) et D11 rudramsa (gains). Elles s’utilisent en complément des seize classiques, sans en faire partie, et chaque réponse le précise. À SAVOIR pour D11 : deux traditions la lisent en sens opposés — l’une pour les gains, comme le suggère la onzième maison, l’autre pour Rudra, et donc la destruction. Nous ne choisissons pas à votre place.

• POST /api/astro/panchamsa/
• POST /api/astro/shashthamsa/
• POST /api/astro/ashtamsa/
• POST /api/astro/rudramsa/

Au-delà de D60 — 3 nouveaux

D81 navnavamsa, D108 astottaramsa et D144 dwadasdwadasamsa. CE SONT DES DIVISIONS COMPOSÉES, et le moteur propose deux lectures de chacune : une division directe du rashi en 81, 108 ou 144 parties, et un varga d’un varga. Ces routes servent la version COMPOSÉE, car c’est ce que dit littéralement chaque nom : nava-navamsa est le navamsa du navamsa, dwadas-dwadasamsa le dwadasamsa du dwadasamsa. La forme par division directe reste accessible via /api/astro/chart/ sous les noms NavnavamsaChart, AstottaramsaChart et DwadasdwadasamsaChart, et elle donne un signe différent pour la plupart des planètes : ce sont des cartes différentes, pas deux orthographes de la même. Un test vérifie que les deux diffèrent bien, pour que ce choix ne puisse pas être inversé par accident. Avec 22, 17 et 12 minutes d’arc par division, ces cartes ne valent la peine d’être lues que si l’heure de naissance est réellement connue à la minute près ; en deçà, elles ne reflètent que l’arrondi de votre acte de naissance.

• POST /api/astro/navnavamsa/
• POST /api/astro/astottaramsa/
• POST /api/astro/dwadasdwadasamsa/

La documentation les classe désormais par ordre de division

La référence triait chaque groupe par ordre alphabétique, ce qui plaçait D10 avant D2 et D144 avant D16 — un fouillis qui donnait l’impression d’une série incomplète même quand elle ne l’était pas, car un lecteur qui cherchait D20 ne savait pas où regarder. Les cartes divisionnaires sont désormais triées par numéro de division partout où elles sont listées.

Rien de ce qui existe n’a changé

Les quinze sont de nouvelles routes qui fixent un chart_name et délèguent pour le reste à la vue qui sert déjà /api/astro/planet-positions/. /api/astro/chart/ accepte toujours tous les chart_name qu’il acceptait auparavant, y compris les variantes de calcul qui n’ont pas de route propre — ParivrittidwayaHora, SomnathDrekkana, JagannathDrekkana et les autres. Celles-ci restent où elles sont : ce sont des variantes d’une division qui a déjà sa route, recherchées par des gens qui savent quel nom ils veulent.

Rashifal par période et par domaine — 6 nouveaux

/api/astro/rashifal/ renvoie un échantillon tournant de 3 à 4 domaines, qui varie selon la date : une page « Bélier Santé » ne pouvait donc pas exister, puisque certains jours la santé ne figurait pas dans l’échantillon. Ces six endpoints renvoient TOUS les domaines à chaque appel : general, career_business, love_relationships, money_finances, health, education_student, family, travel, plus deux que le moteur de base n’a jamais eus, business et professionals. Passez aspect pour n’en obtenir qu’un, la forme qui convient à une page par domaine. Les textes sont déterministes : le même signe, la même période, le même domaine et la même date renvoient toujours les mêmes mots, si bien qu’une page peut être mise en cache sans se contredire au rechargement. La version hebdomadaire ajoute les meilleurs jours et les jours difficiles ; la mensuelle, les transits, les jours particuliers et les remèdes ; l’annuelle, une prévision trimestrielle et les éléments porte-bonheur. rashi et aspect ne tiennent pas compte de la casse, comme sur l’endpoint existant.

• POST /api/astro/rashifal/daily/
• POST /api/astro/rashifal/tomorrow/
• POST /api/astro/rashifal/yesterday/
• POST /api/astro/rashifal/weekly/
• POST /api/astro/rashifal/monthly/
• POST /api/astro/rashifal/yearly/

Neuf systèmes de numérologie — 10 nouveaux

La kabbale associe un nom aux 22 sentiers de l’Arbre, chacun avec sa lettre hébraïque et son atout du tarot. La guématrie évalue un texte hébreu selon cinq chiffrements (standard, gadol, ordinal, katan, atbash). Le tarot donne les cartes de naissance, de partenaire et du nom ; le Yi King, les hexagrammes de naissance et du nom parmi les 64 de la séquence King Wen ; Sepharial, sa propre table de 1920 avec ses maîtres planétaires ; Cheiro, la table chaldéenne lue jusqu’à un nombre composé. L’abjad et l’isopséphie évaluent l’arabe et le grec, y compris les lettres numérales tombées en désuétude — digamma, koppa, sampi. TROIS DE CES SYSTÈMES DÉPENDENT DE L’ÉCRITURE : l’abjad est arabe, l’isopséphie grecque, la guématrie hébraïque. Si on leur envoie une autre écriture, ils renvoient la valeur 0 et listent chaque caractère dans unscored au lieu de translittérer, car chaque source translittère différemment, et un nombre affirmé avec aplomb à partir d’un choix arbitraire est pire qu’un zéro évident.

• POST /api/astro/numerology/kabbalah/
• POST /api/astro/numerology/gematria/
• POST /api/astro/numerology/tarot/
• POST /api/astro/numerology/iching/
• POST /api/astro/numerology/sepharial/
• POST /api/astro/numerology/abjad/
• POST /api/astro/numerology/isopsephy/
• POST /api/astro/numerology/angel/
• POST /api/astro/numerology/aura/
• POST /api/astro/numerology/cheiro/

Lal Kitab : maisons, planètes et disposition du thème — 3 nouveaux

La même tradition à maisons fixes que les deux routes ajoutées hier, sous les trois formes à partir desquelles une page s’affiche réellement. /horoscope/ présente le thème sous forme de douze cases de signes, avec le degré de chaque occupant dans son signe. /houses/ donne pour chaque maison son maître, les grahas dont elle est le pakka ghar, et qui y est exalté ou en chute — pakka_ghar est une LISTE, car Mercure et Vénus partagent la 7e, Mars et Saturne la 8e, Jupiter et Rahu la 12e, et une valeur unique en ferait disparaître un. /planets/ donne pour chaque graha sa dignité et sa nature. La nature de la Lune et celle de Mercure sont calculées plutôt que fixées — la Lune d’après son paksha, Mercure selon qu’un maléfique naturel partage ou non son signe — et chaque ligne contient nature_basis, qui indique la règle appliquée. À SAVOIR : position vaut null pour Rahu et Ketu, sauf s’ils sont exaltés ou en chute. Ils ne gouvernent aucun signe : « le signe d’un ami » n’a donc rien à quoi se mesurer.

• POST /api/astro/lal-kitab/horoscope/
• POST /api/astro/lal-kitab/houses/
• POST /api/astro/lal-kitab/planets/

Ce à quoi nous refusons toujours de répondre

Les dettes du Lal Kitab (rin) et la dasha du Lal Kitab sont absentes à dessein, tout comme les champs soya et kismat que d’autres fournisseurs renvoient sur leur endpoint de maisons. Les noms des huit dettes font consensus entre les sources ; les conditions qui déclenchent chacune d’elles, non : rien que pour pitra rin, les règles publiées divergent au point de donner des réponses différentes pour le même thème. Il en va de même pour soya. Nous préférons ne rien renvoyer plutôt que de publier un verdict sur les ancêtres de quelqu’un à pile ou face : ces champs sont donc absents, et la réponse explique pourquoi.

Rien de ce qui existe n’a changé

Les dix-neuf sont de nouvelles routes. /api/astro/rashifal/ prend toujours le même corps et renvoie le même échantillon tournant ; les neuf nouveaux systèmes de numérologie forment leur propre module au lieu d’ajouter des valeurs à /api/astro/numerology/, si bien que les champs system et keys existants restent intacts. Cheiro réutilise la table chaldéenne des lettres et les significations des nombres composés que l’API contenait déjà, au lieu de les redéfinir.

Rapports PDF finis — 2 nouveaux

Le corps de la réponse EST le PDF. Pas de seconde requête ni de fichier hébergé : nous ne stockons rien, il n’existe donc aucun lien que quelqu’un d’autre pourrait trouver. N’appelez pas .json() sur ces réponses : écrivez les octets sur le disque (curl -o report.pdf, res.arrayBuffer(), response.content). L’horoscope fait environ 27 pages, avec une table des matières générée ; le livre de l’année découpe les douze prochains mois par pratyantardasha de la Vimshottari plutôt que par mois civil, si bien que ses sections commencent et finissent aux dates que dicte votre thème. Les deux acceptent un bloc de personnalisation facultatif — nom de l’entreprise, coordonnées et un logo_url que nous récupérons et dessinons sur la couverture — pour que votre client voie votre nom et non le nôtre. Les deux sont déterministes : les mêmes données de naissance donnent le même document. Le temps de génération habituel est inférieur à deux secondes.

• POST /api/astro/pdf/horoscope/ · 25 crédits
• POST /api/astro/pdf/yearbook/ · 25 crédits

Kala Sarpa et Karakamsa — 2 nouveaux

Kala Sarpa indique quels grahas sont tombés de quel côté de l’axe Rahu–Ketu, et pas seulement oui ou non : la plupart des thèmes ne sont pas Kala Sarpa, et les deux listes montrent si un thème l’a manqué d’un graha ou de quatre. La forme nommée (Anant, Kulik, Vasuki…) n’est renseignée que si le yoga est effectivement formé. À SAVOIR : /api/astro/karakamsa/ classe les chara karakas selon le degré À L’INTÉRIEUR du signe, et désignera pour la plupart des thèmes un autre Atmakaraka que /api/astro/chara-karakas/. Les deux sont calculés différemment et ne sont pas interchangeables ; préférez le nouveau pour le travail sur le karakamsa.

• POST /api/astro/kalsarp/
• POST /api/astro/karakamsa/

Chakra Sarvatobhadra — 1 nouveau

La grille de transit de neuf cases sur neuf, renvoyée en entier avec les placements, pour que vous puissiez la dessiner au lieu de seulement en lire un verdict : chaque case indique ce qu’elle contient, sa teinte et les quatre syllabes de pada de son nakshatra. Passez transit_date_time pour placer les grahas en transit sur la même grille ; hits_natal liste alors ceux dont le vedha tombe sur un nakshatra occupé dans votre thème natal. Seul le vedha positionnel est appliqué, et rule le précise dans chaque réponse, car les écoles divergent et une réponse sans étiquette ne peut pas être vérifiée. Un nakshatra dont nous ne reconnaissons pas l’orthographe est renvoyé dans unplaced au lieu d’être écarté.

• POST /api/astro/sarvatobhadra/

Lal Kitab — 2 nouveaux

Une tradition distincte, venue d’Inde du Nord. La première chose à savoir : EN LAL KITAB, LES MAISONS SONT FIXÉES AUX SIGNES — la maison 1 est toujours le Bélier, et ainsi de suite jusqu’à la maison 12, toujours les Poissons, pour tous les thèmes. La maison d’une planète est le numéro de son signe : ces endpoints SERONT donc en désaccord avec /api/astro/chart/ et /api/astro/planet-positions/ pour presque tout le monde. C’est le système, pas une erreur. Chaque graha est renvoyé avec son pakka ghar et l’indication qu’il s’y trouve ou non. Le varshphal est arithmétique et non astronomique : chaque planète avance d’une maison par année d’âge révolue, si bien que le thème annuel revient à la disposition natale tous les douze ans.

• POST /api/astro/lal-kitab/chart/
• POST /api/astro/lal-kitab/varshphal/

Le Playground peut vous remettre le fichier

Lorsqu’un endpoint répond par un fichier, le Playground affiche désormais son nom, son type et sa taille avec un bouton de téléchargement, au lieu d’essayer d’afficher les octets comme du texte. La page de référence de ces endpoints ne vous dit plus non plus de les décompresser et de les analyser : cette formulation concernait les routes en JSON compressé (gzip) et était fausse pour un PDF.

Rien de ce qui existe n’a changé

Les cinq endpoints de calcul sont de nouvelles routes qui délèguent aux vues servant déjà /api/astro/planet-positions/ et les cartes divisionnaires : leurs nombres sont identiques par construction. Les rapports PDF sont assemblés en appelant ces mêmes endpoints en interne — les positions imprimées en page 3 sont exactement celles que renvoie /api/astro/planet-positions/ — et le rapport entier est facturé comme un seul appel, et non comme les vingt-cinq qui le composent.

Dashas de nakshatra conditionnelles — 7 nouvelles

Fondées sur les planètes : chaque maître de la réponse est un graha. Toutes les sept sont CONDITIONNELLES — les textes classiques ne les appliquent que lorsqu’un thème remplit une condition précise : vérifiez donc /api/astro/dasha_applicability/ avant d’en proposer une comme lecture.

• POST /api/astro/dasha/dwadashottari/
• POST /api/astro/dasha/panchottari/
• POST /api/astro/dasha/sataabdika/
• POST /api/astro/dasha/chaturaseeti-sama/
• POST /api/astro/dasha/dwisaptati/
• POST /api/astro/dasha/shattrimsa-sama/
• POST /api/astro/dasha/budhi-gati/

Dashas de rashi de Jaimini — 15 nouvelles

Fondées sur les signes : ici, chaque maître est un rashi, pas une planète. C’est la différence à surveiller : le champ lord ne désigne pas le même genre de chose que dans les dashas de nakshatra ci-dessus, et lire le mauvais vous donne un résultat impossible à interpréter.

• POST /api/astro/dasha/drig/
• POST /api/astro/dasha/nirayana-shoola/
• POST /api/astro/dasha/shoola/
• POST /api/astro/dasha/sthira/
• POST /api/astro/dasha/trikona/
• POST /api/astro/dasha/brahma/
• POST /api/astro/dasha/chakra/
• POST /api/astro/dasha/kendradhi/
• POST /api/astro/dasha/lagnamsaka/
• POST /api/astro/dasha/mandooka/
• POST /api/astro/dasha/navamsa/
• POST /api/astro/dasha/paryaaya/
• POST /api/astro/dasha/sandhya/
• POST /api/astro/dasha/tara-lagna/
• POST /api/astro/dasha/yogardha/

Une branche au lieu de l’arbre entier — 1 nouveau

levels limite la PROFONDEUR d’une réponse de dasha, mais renvoie quand même toutes les périodes à cette profondeur : levels=3 sur la Vimshottari donne chaque pratyantardasha de chaque antardasha de chaque mahadasha — 95 Ko mesurés. Envoyez {"lords": ["moon", "mars"], "levels": 1} et vous n’obtenez que les périodes de cette antardasha, environ 1,8 Ko. Cela économise le transfert et l’analyse, pas le calcul.

• POST /api/astro/dasha/drill/

Chat astrologique — 1 nouveau

Envoyez des données de naissance et une question, recevez une réponse rédigée — avec les passages classiques sur lesquels elle s’appuie, chacun cité et noté, pour que le raisonnement puisse être vérifié. Les données de naissance viennent de VOTRE requête et non d’un compte : vous pouvez donc poser la question pour n’importe lequel de vos utilisateurs. Ajoutez compare_with pour les questions de compatibilité, et passez jusqu’à vingt échanges précédents dans history. Rien n’est conservé entre les appels. Coût : 25 crédits au lieu de 1, car chaque réponse fait tourner un modèle de langage sur le thème calculé ; une réponse en échec ou vide ne coûte rien.

• POST /api/astro/chat/ · 25 crédits

Trente systèmes de dasha, désormais groupés par famille

Avec ceux-ci, trente systèmes ont un endpoint nommé, contre huit auparavant — les autres n’étaient accessibles qu’en passant une chaîne à /api/nakshatra_dasha/ ou /api/raasi_dasha/, si bien qu’une recherche sur « narayana dasha » ne trouvait rien. Dans la référence, ils sont désormais répartis en trois groupes — nakshatra (planète), rashi (Jaimini) et outils — au lieu d’une seule liste alphabétique de trente-cinq entrées qui plaçait la Brahma dasha à côté de la Budhi Gati dasha.

Rien de ce qui existe n’a changé

/api/nakshatra_dasha/ et /api/raasi_dasha/ sont intacts, et les huit endpoints de dasha qui existaient déjà se comportent exactement comme avant : chaque nouvelle route délègue à la même vue parente, si bien que les nombres sont identiques par construction, et non grâce à une copie qui pourrait diverger. L’endpoint de chat est distinct des routes /api/ai/ existantes de l’application, qui ne changent pas.

Les nouveautés

POST /api/astro/prashnavali/ram-shalaka/ renvoie les 225 chaupais de la Ram Shalaka Prashnavali, chacun avec sa lettre devanagari, le chaupai lui-même, son emplacement dans le Ramcharitmanas et une réponse en anglais. /api/astro/prashnavali/hanuman/ renvoie les 49 réponses numérotées, /api/astro/prashnavali/sai/ les 720 réponses Sai, et /api/astro/prashnavali/mavji/ les 64 lectures de Mavji Maharaj en hindi et en anglais. Les quatre sont regroupés sous une nouvelle catégorie Avatar chakra dans la référence.

Trois choses qu’ils font et que l’endpoint parent ne fait pas

Le filtre est partout facultatif. /api/astro/chakra/ rejette une requête sai_prashnavali qui arrive sans numéro ; ces endpoints renvoient alors l’ensemble complet, ce qui correspond à l’usage normal des données d’oracle : récupérer une fois, mettre en cache, indexer localement. Les entrées reviennent sous forme de LISTE, avec l’index porté par chaque entrée, plutôt que sous forme d’objet indexé par des nombres convertis en chaînes : vous pouvez les parcourir dans l’ordre sans trier numériquement des clés textuelles (qui, sinon, donnent 1, 10, 100, 11). Enfin, chaque réponse contient un count : une consultation d’une seule entrée se distingue d’une récupération complète sans examiner le contenu.

Rien de ce qui existe n’a changé

/api/astro/chakra/ est intact. Il sert toujours les quatre jeux de données derrière son champ keys, renvoie toujours la même forme {key: data} et renvoie toujours 400 pour sai_prashnavali sans numéro. Si vous êtes déjà intégré à cet endpoint, rien ici ne vous concerne : ce sont des routes supplémentaires, pas un remplacement.

Renommés dans la référence

« KP (Krishnamurti) chart » et « Krishnamurti paddhati » deviennent « KP chart (cusps, signs and planets) » et « KP parts (pick with keys) » : le premier vous donne le thème entier, le second vous fait nommer les parties voulues. « House lord placements » et « House lord placement », qui ne différaient que d’une lettre, deviennent « (all 144) » et « (one pair) ». Deux endpoints tous deux appelés « Pancha Pakshi » deviennent « (bird activity by hora) » et « (day in ten yamas) ». « Birth panchanga effects » et « Birth panchanga readings » deviennent « (reference table) » et « (your elements) ».

Les routes n’ont pas changé

Seuls les noms affichés dans la documentation changent. Chaque route, chaque champ de requête et chaque champ de réponse est exactement comme avant : rien à mettre à jour dans votre intégration. Si vous avez mis une page de la documentation en favori, l’URL fonctionne toujours ; seul le titre en haut de page est plus clair.

Des captures d’écran sur les pages de référence

43 pages d’endpoints affichent désormais une capture d’écran des données de l’endpoint dans une interface fonctionnelle — panchang, choghadiya, calendrier des fêtes, rétrogradations, onze calendriers régionaux, thèmes natals, etc. Une table de champs vous dit la forme d’une réponse, pas à quoi elle sert, et un coup d’œil suffit généralement à savoir si c’est l’endpoint qu’il vous faut. L’index de la documentation et la page d’accueil présentent les mêmes captures.

Ce qui change

/api/astro/chart/ accepte désormais un champ render facultatif. Sans lui, rien ne change : la réponse est exactement la même qu’avant. Réglez-le sur "svg" et deux champs apparaissent à côté des quatre habituels : layout (pour chaque case de maison ou de signe, les points de son polygone, la position de son étiquette et les planètes qui l’occupent) et svg (le balisage rendu, à insérer tel quel dans une page). chart_style choisit le style nord-indien (le losange, maisons fixes, signes qui tournent) ou sud-indien (la grille de signes fixe, maisons qui tournent) ; svg_size, theme, label_style, show_degrees et quatre champs *_color règlent l’apparence.

Pourquoi c’est important

Construire une roue de thème à partir des longitudes brutes est un vrai travail — géométrie des maisons, rotation des signes, placement des étiquettes — que chaque intégrateur refaisait de zéro. Désormais, c’est un champ de plus dans un appel que vous faisiez déjà. La géométrie de mise en page est là pour ceux qui font un rendu natif en React, Canvas, Flutter ou SwiftUI plutôt que d’utiliser notre balisage.

Rien de ce qui existe n’a changé

render vaut "none" par défaut, et chaque autre nouveau champ a une valeur par défaut sans effet. Une requête qui n’en mentionne aucun reçoit une réponse vérifiée identique, octet pour octet, à celle d’avant cette mise en production, pour chaque type de thème et chaque option que cet endpoint accepte.

Des dashas que l’on peut chercher

Nous calculions déjà trente systèmes de dasha — onze dashas de nakshatra et dix-neuf dashas de rashi, chacune sur plusieurs niveaux d’imbrication — mais ce n’étaient que des valeurs d’une chaîne dasha_type sur deux endpoints appelés nakshatra_dasha et raasi_dasha. Une recherche sur « vimshottari dasha » ne trouvait rien. Il existe désormais des routes nommées : /api/astro/dasha/vimshottari/, /yogini/, /ashtottari/, /chara/, /narayana/, /kalachakra/ et d’autres, plus /api/astro/dasha/systems/, qui liste chaque système avec l’endpoint qui le sert. Les deux endpoints d’origine sont intacts et continuent de fonctionner.

Quelle dasha est en cours en ce moment

/api/astro/dasha/current/ répond à la question que les endpoints de chronologie ne pouvaient pas traiter : il renvoie la chaîne à partir de la mahadasha — « Jupiter / Ketu / Mercury » — avec, pour chaque niveau, le début et la fin, le degré d’avancement et le nombre de jours restants. Auparavant, il fallait récupérer l’arbre entier, le parcourir récursivement et comparer les dates dans votre propre code.

Astrologie occidentale traditionnelle et hellénistique

/api/astro/traditional/dignities/ renvoie domicile, exaltation, triplicité, terme et face pour chaque planète, avec le score de Lilly ; /almuten/ donne la planète qui a le plus de dignités sur chaque point du thème ; /sect/ indique si un thème est diurne ou nocturne et ce qui en découle ; /profections/ donne les profections annuelle, mensuelle et quotidienne avec le Maître de l’année. Ces calculs sont tropicaux, comme l’exige la doctrine, et la réponse indique quelles tables de termes et de triplicités ont été utilisées : les sources divergent, et un score calculé sur une autre table est un autre nombre.

Thèmes dérivés et Lune

Thèmes draconiques, harmoniques, antisces, héliocentriques et de Davison sous /api/astro/western/, plus /api/astro/lunar/void-of-course/ et /api/astro/lunar/mansions/. La Lune hors cours (void of course) est une recherche vers l’avant, pas un instantané : elle avance jusqu’au changement de signe de la Lune, indique chaque aspect qui deviendra exact et à quel moment précis, et vous dit quand la période hors cours commence et finit.

Les Quatre Piliers chinois

/api/astro/chinese/four-pillars/, /bazi/, /zodiac/ et /luck-pillars/. L’année chinoise commence à Lichun, vers le 4 février — ni le 1er janvier, ni au Nouvel An chinois, qui est une date lunaire et régit la fête, pas le thème. Une naissance le 20 janvier 2024 renvoie un Lapin d’Eau, pas un Dragon de Bois. Les conventions de limite du jour et de temps solaire vrai sont toutes deux des champs de requête, car les praticiens divergent et chacune modifie le thème.

Tarot

/api/astro/tarot/draw/, /spread/, /yes-no/ et /deck/. Chaque tirage renvoie la graine qui l’a produit, et renvoyer cette graine reproduit exactement le tirage — mêmes cartes, même ordre, même orientation. C’est ce qui permet de conserver une lecture et de la réafficher, au lieu de donner au consultant une réponse différente à la même question. Six tirages nommés, jusqu’à la croix celtique à dix cartes, avec chaque position étiquetée.

Autres nouveautés

/api/astro/eclipse/visibility-path/ trace la zone où une éclipse solaire est totale, sous forme de coordonnées à reporter sur une carte, avec le point de plus grande éclipse et sa série de Saros. Neuf autres endpoints isolent des calculs qui exigeaient auparavant de savoir quelles clés demander à un endpoint plus large : prastara et sodhana de l’ashtakavarga, aspects et yogas tajika, coordonnées horizontales et équatoriales des planètes, illumination de la Lune, segments de vasa et cazimi.

Rien de ce qui existe n’a changé

Chaque endpoint ajouté ici est une nouvelle route. Aucun corps de requête, aucune forme de réponse ni aucun nom de champ d’un endpoint existant n’a été modifié, et aucun endpoint n’a été supprimé ou renommé. Les tarifs ne changent pas : un appel réussi coûte un crédit, quel que soit son résultat.

Ce qui change

Des endpoints comme /api/astro/sunrise/, /api/astro/tithi/, /api/astro/navamsa/ et /api/astro/rahu-kaal/ prennent chacun les champs habituels de naissance ou de date, et ne renvoient que ce que leur nom indique. Les endpoints combinés existants sont inchangés et fonctionnent exactement comme avant.

Pourquoi c’est important

Afficher une heure de lever du soleil n’oblige plus à demander, payer et analyser une réponse complète de panchang. Des réponses plus légères, moins de code de mapping, et un corps de requête lisible.

Comment commencer

Parcourez la référence et envoyez l’exemple de requête avec votre clé dans l’en-tête X-API-Key. Les tarifs ne changent pas : un appel réussi coûte un crédit, quel que soit son résultat.

Ce qui change

La recherche porte sur la fonctionnalité, pas seulement sur le nom de l’endpoint. Taper « manglik » trouve l’endpoint des doshas même si le mot « manglik » ne figure pas dans son nom, et le résultat indique quel champ correspond.

Pourquoi c’est important

Plusieurs centaines de champs se cachent derrière la liste des endpoints. Sans recherche sur les noms de champs, trouver celui qu’il vous fallait obligeait à ouvrir les endpoints un par un et à lire leurs réponses.

Ce qui change

Le serveur MCP occult-api expose sous forme d’outils la recherche d’endpoints, leurs descriptions et les appels. Donnez-lui votre clé API, et un assistant peut trouver le bon endpoint et l’appeler directement.

Pourquoi c’est important

C’est le moyen le plus rapide de tester l’API sur une vraie question avant de vous lancer dans un développement, et il sert aussi d’implémentation de référence fonctionnelle du format de requête.

Ce qui change

Chaque page d’endpoint mène directement au Playground, avec son exemple de requête déjà rempli. Modifiez la latitude, la date ou l’ayanamsa, et renvoyez la requête.

Pourquoi c’est important

Lire un exemple de réponse vous montre la forme des données. Envoyer vos propres entrées vous dit si l’API répond à votre question.

Ce qui change

Inscrivez-vous, générez une clé et envoyez-la dans l’en-tête X-API-Key. Les crédits sont déduits à chaque appel réussi — une requête en échec n’est jamais facturée.

Pourquoi c’est important

Pas de grille tarifaire par endpoint à décortiquer. Les calculs s’appuient sur les éphémérides NASA JPL, avec un ensemble complet d’ayanamsas classiques et modernes.