Registro de cambios

Mudda dasha

Mudda dasha ya está bien escrito y vive en /api/astro/mudda-dasha/, junto a Muntha, en la sección de Tajika y varshaphala. El antiguo /api/astro/muddha_dasha/ queda retirado. El nuevo endpoint devuelve los señores por su nombre y cada inicio como marca de tiempo ISO, en vez de números de planeta y una cadena de fecha con un diccionario de grados dentro.

• POST /api/astro/mudda-dasha/

Qué sustituye a qué

Aspectos tajika: usa /api/astro/tajika/aspects/ en lugar de /api/astro/tajaka/. Yogas tajika: /api/astro/tajika/yogas/ en lugar de /api/astro/tajaka_yoga/. Sahams: /api/astro/sahams/ en lugar de /api/astro/saham/. Prashnavali: los cuatro endpoints de /api/astro/prashnavali/ en lugar de /api/astro/chakra/. Gun milan: /api/astro/ashtakoota/ con la clave `compatibility_score`, que devuelve los mismos trece valores (las ocho puntuaciones de los kootas, el total sobre 36 y las cuatro comprobaciones del sur de la India), en lugar de /api/astro/gun-milan/. Shadbala: /api/astro/strength/ en lugar de /api/astro/shadbala/. Dashas de nakshatra y de rashi: /api/astro/dasha/nakshatra/ y /api/astro/dasha/rashi/ en lugar de /api/nakshatra_dasha/ y /api/raasi_dasha/. Eclipses: los siete endpoints con nombre de /api/astro/eclipse/ en lugar del /api/astro/eclipse/ genérico. KP: /api/astro/kp-chart/ en lugar de /api/astro/krishnamurti/.

Si llamas a un endpoint retirado

Cualquier llamada a uno de ellos con una clave de API devuelve ahora 403 endpoint_not_allowed y no gasta créditos. Cámbiate al endpoint que lo sustituye, según la lista de arriba; el SDK y la colección de Postman ya los usan.

• 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/

Qué ha cambiado

Ya no ofrecemos la lista de famosos ni la consulta de un famoso concreto. Una llamada a cualquiera de los dos con una clave de API devuelve 403 endpoint_not_allowed y no gasta créditos. Los demás endpoints no cambian. Si guardaste datos de nacimiento obtenidos de estos endpoints, puedes seguir enviándolos a los endpoints de cartas como cualquier otro dato de nacimiento.

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

Jamakkol Prashna

Envía la hora local en que se hizo la pregunta, junto con el lugar y su diferencia con UTC. Recibes los ocho jama grahas, Udhayam, Arudam y Kavippu, el jamam del día o de la noche, Kuligan, Emakandam, Mrithyu y Rahu Time, los planetas y el panchanga de ese momento. Pasa arudam_sign cuando el consultante elige el signo; si lo omites, el Arudam se toma del reloj. Lo hemos contrastado con jamakkol.com en más de 20 cartas; para coincidir exactamente con esa web, envía el ayanamsa true_citra con el nodo medio.

• POST /api/astro/prashna/jamakkol/

Ashtamangala Prashna

Envía el momento y el lugar, el signo Arudha que eligió el consultante y las cauris, en tres montones o como número de tres cifras. Recibes el Arudha, el Chatra, los seis rasis del Prasna Kriya con el órgano que rige cada uno, los cinco Sutras, los planetas contados desde el Lagna y desde el Arudha, y la lectura completa del número, cifra a cifra. Los sphutas no se repiten aquí: llama a /api/astro/prashna/ con el mismo momento para obtenerlos.

• POST /api/astro/prashna/ashtamangala/

Qué ha cambiado

Todos estos endpoints comparten el serializador de solicitud de /api/astro/panchanga/, el único que de verdad calcula las más de cincuenta claves del panchang y necesita todos los datos configurables que usan esas claves en conjunto. Los endpoints concretos heredaban esa lista de campos completa sin necesitarla. Así, /day-night-length/, que solo hace cuentas de salida y puesta del sol, documentaba y aceptaba gulika_rises_at, gulika_portion, mandi_rises_at, mandi_portion, kala_mrityu_rise_at y dhuma_vyatipata_relation (ajustes de puntos sombra), samvata_type y mode (selectores de era y de cómputo), y mean_anomaly, eccentricity, eccentric_anomaly, tolerance y nakshatras: trece campos que su cálculo no leía nunca. Ahora cada endpoint documenta y acepta solo los campos que su cálculo usa de verdad: /samvat/ conserva samvata_type, /lunar-month/ conserva mode, /upagraha/ conserva los seis campos de gulika, mandi, kala-mrityu y dhuma-vyatipata, y los otros 26 no conservan ninguno de los trece.

• 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/

Por qué importa

Si un campo aparece en la página de referencia de un endpoint, se entiende que configurarlo sirve para algo. Y no servía: enviar gulika_rises_at a /day-night-length/ siempre se ignoraba sin avisar, lo que es peor que no tener el campo, porque invita a perder tiempo ajustando algo que nunca puede cambiar el resultado. Ahora la página de cada endpoint muestra exactamente los parámetros que afectan a su resultado, ni uno más.

No se rompe nada

El cálculo de estos endpoints nunca leía estos campos, así que quitarlos de la documentación y del esquema no cambia el comportamiento de ningún endpoint. Si tu integración ya envía alguno de ellos, por ejemplo a /day-night-length/, la solicitud sigue funcionando y la respuesta es la misma. Antes de publicarlo lo comprobamos con llamadas antes y después en todos los endpoints afectados. La única diferencia es que la página de referencia y los tipos generados del SDK ya no ofrecen un ajuste que nunca hacía nada.

Qué ha cambiado

Catorce bloques: Panchang, Rahu Kaal, Choghadiya, Abhijit y Brahma Muhurat, Durmuhurat, fechas de Ekadashi, Amavasya, Purnima, Pradosh y Sankashti Chaturthi, un calendario de festivales, Rashifal y un formulario de kundli. Cada uno es un bloque real del editor de bloques, que se arrastra desde el insertador como cualquier bloque de WordPress, con su shortcode equivalente para quien siga usando el editor clásico.

Por qué importa

Cualquiera que tenga una web, aunque no haya escrito nunca una línea de PHP, puede añadir un widget de panchang en directo en lo que tarda en arrastrar un bloque y pegar una clave de API. El plugin solo muestra los resultados de los mismos endpoints que aparecen en el resto de este registro; no hace cálculos propios, así que nunca puede contradecir a la API.

Las dieciséis shodasavargas ya tienen ruta: 8 nuevas

D1 rashi, D4 chaturthamsa, D16 shodasamsa, D20 vimsamsa, D24 chaturvimsamsa, D27 nakshatramsa, D40 khavedamsa y D45 akshavedamsa se suman a las ocho que ya estaban publicadas (D2, D3, D7, D9, D10, D12, D30, D60). NO SE CALCULA NADA NUEVO: /api/astro/chart/ siempre pudo generarlas pasando chart_name, y estas rutas usan esa misma vista, así que los números son idénticos por diseño. Lo que cambia es que ahora se pueden encontrar: una ruta llamada /navamsa/ se descubre fácilmente; un chart_name escondido en el cuerpo de una solicitud, no. /api/astro/rashi/ es esa misma vista con la carta fijada y devuelve exactamente los mismos bytes que /api/astro/planet-positions/. Una prueba lo comprueba, así que no pueden desviarse.

• 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/

Cuatro divisiones fuera de la shodasavarga: 4 nuevas

D5 panchamsa (fama y autoridad), D6 shashthamsa (salud y enemigos), D8 ashtamsa (longevidad y sucesos repentinos) y D11 rudramsa (ganancias). Se usan junto a las dieciséis clásicas, no forman parte de ellas, y cada respuesta lo indica. CONVIENE SABER sobre la D11: dos tradiciones la leen en sentidos opuestos. Una la asocia a las ganancias, como sugiere la casa once; la otra, a Rudra y, por tanto, a la destrucción. No elegimos por ti.

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

Más allá de la D60: 3 nuevas

D81 navnavamsa, D108 astottaramsa y D144 dwadasdwadasamsa. SON DIVISIONES COMPUESTAS, y el motor tiene dos lecturas de cada una: dividir el rashi directamente en 81, 108 o 144 partes, o calcular la varga de una varga. Estas rutas devuelven la COMPUESTA, porque es lo que dice literalmente cada nombre: nava-navamsa es la navamsa de la navamsa, y dwadas-dwadasamsa, la dwadasamsa de la dwadasamsa. La división directa sigue disponible en /api/astro/chart/ como NavnavamsaChart, AstottaramsaChart y DwadasdwadasamsaChart, y da otro signo para la mayoría de los planetas: son cartas distintas, no dos formas de escribir la misma. Una prueba comprueba que de verdad difieren, para que nadie pueda invertir la elección por accidente. Con 22, 17 y 12 minutos de arco por división, solo merece la pena leerlas si la hora de nacimiento se conoce de verdad al minuto; si no, lo que reflejan es el redondeo de tu partida de nacimiento.

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

La documentación las ordena ahora por división

La referencia ordenaba cada grupo alfabéticamente, así que la D10 salía antes que la D2 y la D144 antes que la D16. Ese desorden hacía que la serie pareciera incompleta aunque no lo estuviera: quien buscaba la D20 no sabía dónde mirar. Ahora, allí donde aparezcan, las cartas divisionales se ordenan por número de división.

No cambia nada de lo que ya existía

Las quince son rutas nuevas que fijan un chart_name y, por lo demás, usan la misma vista que /api/astro/planet-positions/. /api/astro/chart/ sigue aceptando todos los chart_name que aceptaba, incluidos los cómputos alternativos que no tienen ruta propia: ParivrittidwayaHora, SomnathDrekkana, JagannathDrekkana y demás. Esos se quedan donde están: son variantes de una división que ya tiene ruta, y quien los quiere ya sabe cómo se llaman.

Rashifal por periodo y por área: 6 nuevos

/api/astro/rashifal/ devuelve una selección rotatoria de 3–4 áreas, y cuáles salen cambia con la fecha. Por eso no se podía hacer una página de «Aries: salud», porque algunos días la salud no estaba en la selección. Estos seis devuelven TODAS las áreas en cada llamada: general, career_business, love_relationships, money_finances, health, education_student, family, travel y dos que el motor base nunca incluía, business y professionals. Pasa aspect para obtener solo una, que es justo lo que necesita una página por área. Las lecturas son deterministas: el mismo signo, periodo, área y fecha devuelven siempre el mismo texto, así que la página se puede cachear y no se contradice al recargarla. El semanal añade los mejores días y los días difíciles; el mensual, tránsitos, días especiales y remedios; el anual, una previsión por trimestres y elementos de la suerte. rashi y aspect no distinguen mayúsculas, igual que en el endpoint que ya existía.

• 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/

Nueve sistemas de numerología: 10 nuevos

La Cábala asocia un nombre a los 22 senderos del Árbol, cada uno con su letra hebrea y su arcano mayor del tarot. La gematría puntúa texto hebreo con cinco cifrados (standard, gadol, ordinal, katan, atbash). El tarot da las cartas de nacimiento, de pareja y del nombre; el I Ching, los hexagramas de nacimiento y del nombre según los 64 del rey Wen; Sepharial, su propia tabla de 1920 con sus regentes planetarios; Cheiro, la tabla caldea leída hasta un número compuesto. El abjad y la isopsefía puntúan árabe y griego, incluidas las letras numerales en desuso: digamma, koppa y sampi. TRES DE ELLOS DEPENDEN DE LA ESCRITURA: el abjad es para árabe, la isopsefía para griego y la gematría para hebreo. Si les envías otra escritura, devuelven 0 y listan cada carácter en unscored en lugar de transliterarlo, porque cada fuente translitera a su manera y un número rotundo basado en una elección arbitraria es peor que un cero evidente.

• 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: casas, planetas y disposición de la carta, 3 nuevos

La misma tradición de casas fijas que las dos rutas que añadimos ayer, en las tres formas de las que de verdad se alimenta una página. /horoscope/ es la carta como doce casillas de signo, con el grado de cada ocupante dentro de su signo. /houses/ da para cada casa su regente, los grahas para los que es su pakka ghar y quién está exaltado o debilitado en ella. pakka_ghar es una LISTA, porque Mercurio y Venus comparten la 7.ª, Marte y Saturno la 8.ª, y Júpiter y Rahu la 12.ª, y con un solo valor se perdería uno de ellos. /planets/ da la dignidad y la naturaleza de cada graha. La naturaleza de la Luna y de Mercurio se calcula, no es fija: la de la Luna según su paksha, y la de Mercurio según si comparte signo con un maléfico natural. Cada fila incluye nature_basis, que dice qué regla lo decidió. CONVIENE SABER: position es null para Rahu y Ketu salvo que estén exaltados o debilitados. No rigen ningún signo, así que no hay con qué comparar para decir si están en «el signo de un amigo».

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

Lo que seguimos sin responder

Las deudas del Lal Kitab (rin) y el dasha del Lal Kitab faltan a propósito, igual que los campos soya y kismat que otros proveedores devuelven en su endpoint de casas. Las fuentes coinciden en el nombre de las ocho deudas, pero no en las condiciones que activan cada una: solo con las reglas publicadas para el pitra rin, la misma carta da respuestas distintas. Con soya pasa lo mismo. Preferimos no devolver nada antes que publicar un veredicto sobre los antepasados de alguien a cara o cruz, así que esos campos no aparecen y la respuesta explica por qué.

No cambia nada de lo que ya existía

Las diecinueve son rutas nuevas. /api/astro/rashifal/ sigue recibiendo el mismo cuerpo y devolviendo la misma selección rotatoria. Los nueve sistemas de numerología nuevos son un módulo aparte, no valores nuevos de /api/astro/numerology/, así que los campos system y keys que ya existían no cambian. Cheiro reutiliza la tabla de letras caldea y los significados de los números compuestos que la API ya tenía, en vez de repetirlos.

Informes en PDF terminados: 2 nuevos

El cuerpo de la respuesta ES el PDF. No hay segunda solicitud ni archivo alojado: no guardamos nada, así que no hay ningún enlace que otra persona pueda encontrar. No llames a .json() con estos endpoints; guarda los bytes en disco (curl -o report.pdf, res.arrayBuffer(), response.content). El horóscopo tiene unas 27 páginas, con índice generado. El anuario divide los próximos doce meses por pratyantardasha de Vimshottari, no por meses del calendario, así que cada sección empieza y termina en las fechas que marca tu carta. Los dos aceptan un bloque opcional de marca (nombre de la empresa, datos de contacto y un logo_url que descargamos y ponemos en la portada) para que tu cliente vea tu nombre y no el nuestro. Los dos son deterministas: los mismos datos de nacimiento dan el mismo documento. Lo normal es que tarden menos de dos segundos.

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

Kala Sarpa y Karakamsa: 2 nuevos

Kala Sarpa no se limita a decir sí o no: devuelve qué grahas cayeron a cada lado del eje Rahu–Ketu. La mayoría de las cartas no tienen Kala Sarpa, y las dos listas muestran si a una carta le faltó un graha o cuatro. El nombre de la variante (Anant, Kulik, Vasuki…) solo se rellena cuando el yoga se forma de verdad. CONVIENE SABER: /api/astro/karakamsa/ ordena los chara karakas por el grado DENTRO del signo y, en la mayoría de las cartas, dará un Atmakaraka distinto del de /api/astro/chara-karakas/. Se calculan de forma diferente y no son intercambiables; para trabajar con el karakamsa, usa el nuevo.

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

Chakra Sarvatobhadra: 1 nuevo

El tablero de tránsitos de nueve por nueve. Devuelve la cuadrícula completa junto con las posiciones, para que puedas dibujarla y no solo leer un veredicto: cada casilla indica qué contiene, su sombreado y las cuatro sílabas de pada de su nakshatra. Pasa transit_date_time para colocar los grahas en tránsito en el mismo tablero; hits_natal lista entonces aquellos cuyo vedha cae en un nakshatra ocupado en tu carta natal. Solo se aplica el vedha posicional, y rule lo indica en cada respuesta, porque las escuelas discrepan y una respuesta sin etiquetar no se puede comprobar. Si recibimos un nakshatra escrito de una forma que no sabemos ubicar, aparece en unplaced en lugar de descartarse.

• POST /api/astro/sarvatobhadra/

Lal Kitab: 2 nuevos

Es una tradición aparte del norte de la India, y lo primero que hay que saber es que EN EL LAL KITAB LAS CASAS ESTÁN FIJADAS A LOS SIGNOS: la casa 1 es siempre Aries, y así hasta la casa 12, que es siempre Piscis, en todas las cartas. La casa de un planeta es el número de su signo, así que estos endpoints NO COINCIDIRÁN con /api/astro/chart/ ni con /api/astro/planet-positions/ para casi nadie. Es el sistema, no un error. Cada graha incluye su pakka ghar y si está en él. El varshphal es aritmético, no astronómico: cada planeta avanza una casa por cada año cumplido, así que la carta anual vuelve a la disposición natal cada doce años.

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

El Playground te da el archivo

Al ejecutar un endpoint que responde con un archivo, ahora ves su nombre, tipo y tamaño, con un botón para descargarlo, en lugar de intentar mostrar los bytes como texto. Y la página de referencia de esos endpoints ya no dice que hay que descomprimirlos y analizarlos: ese texto era para las rutas de JSON comprimido con gzip y no tenía sentido para un PDF.

No cambia nada de lo que ya existía

Los cinco endpoints de cálculo son rutas nuevas que usan las mismas vistas que /api/astro/planet-positions/ y las cartas divisionales, así que sus números son idénticos por diseño. Los informes en PDF se montan llamando internamente a esos mismos endpoints (las posiciones de la página 3 son exactamente las que devuelve /api/astro/planet-positions/), y el informe completo se cobra como una sola llamada, no como las veinticinco con las que se construye.

Dashas condicionales de nakshatra: 7 nuevos

Basados en planetas: todos los señores de la respuesta son grahas. Los siete son CONDICIONALES: los textos clásicos solo los aplican si la carta cumple una condición concreta, así que consulta /api/astro/dasha_applicability/ antes de ofrecer uno como lectura.

• 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 nuevos

Basados en signos: aquí cada señor es un rashi, no un planeta. Esa es la diferencia que hay que vigilar: el campo lord significa algo distinto que en los dashas de nakshatra de arriba, y si lo lees como lo que no es, obtendrás un resultado que no sabrás interpretar.

• 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/

Una rama en lugar del árbol entero: 1 nuevo

levels limita la PROFUNDIDAD de una respuesta de dasha, pero sigue devolviendo todos los periodos de ese nivel: levels=3 en Vimshottari son todos los pratyantardashas de todos los antardashas de todos los mahadashas, 95 KB medidos. Envía {"lords": ["moon", "mars"], "levels": 1} y recibirás solo los periodos de ese antardasha, unos 1.8 KB. Ahorra transferencia y procesamiento de la respuesta, no cálculo.

• POST /api/astro/dasha/drill/

Chat de astrología: 1 nuevo

Envía los datos de nacimiento y una pregunta, y recibirás la respuesta en texto, con los pasajes clásicos en los que se basa, cada uno citado y puntuado, para que se pueda comprobar el razonamiento. Los datos de nacimiento vienen de TU solicitud, no de una cuenta, así que puedes preguntar en nombre de cualquiera de tus usuarios. Añade compare_with para preguntas de compatibilidad, y pasa hasta veinte turnos anteriores en history. No se guarda nada entre llamadas. Cuesta 25 créditos en lugar de 1, porque cada respuesta pasa la carta calculada por un modelo de lenguaje; si la respuesta falla o llega vacía, no cuesta nada.

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

Treinta sistemas de dasha, ahora agrupados por familia

Con estos, ya son treinta los sistemas con endpoint propio, frente a ocho antes. El resto solo se podía usar pasando una cadena a /api/nakshatra_dasha/ o /api/raasi_dasha/, así que quien buscaba «narayana dasha» no encontraba nada. En la referencia ahora se dividen en tres grupos (nakshatra o planetarios, rashi o Jaimini, y herramientas) en lugar de una única lista alfabética de treinta y cinco que ponía el Brahma dasha junto al Budhi Gati dasha.

No cambia nada de lo que ya existía

/api/nakshatra_dasha/ y /api/raasi_dasha/ no se han tocado, y los ocho endpoints de dasha que ya existían funcionan exactamente igual. Cada ruta nueva usa la misma vista principal, así que los números son idénticos por diseño, no por una copia que pudiera desviarse. El endpoint de chat es independiente de las rutas /api/ai/ que ya tenía la app, que no cambian.

Qué hay de nuevo

POST /api/astro/prashnavali/ram-shalaka/ devuelve las 225 chaupais del Ram Shalaka Prashnavali, cada una con su letra en devanagari, la chaupai, en qué parte del Ramcharitmanas aparece y una respuesta en inglés. /api/astro/prashnavali/hanuman/ devuelve las 49 respuestas numeradas; /api/astro/prashnavali/sai/, las 720 respuestas de Sai, y /api/astro/prashnavali/mavji/, las 64 lecturas de Mavji Maharaj en hindi y en inglés. En la referencia, los cuatro están agrupados en una nueva categoría: Avatar chakra.

Tres cosas que hacen y el endpoint original no

El filtro es opcional en todos. /api/astro/chakra/ rechaza una solicitud de sai_prashnavali que llegue sin número; estos endpoints, en cambio, devuelven el conjunto completo, que es como se suelen usar los datos de un oráculo: se descargan una vez, se guardan en caché y se indexan en local. Las entradas llegan como una LISTA, con el índice dentro de cada entrada, en lugar de un objeto con números convertidos en texto como claves. Así puedes recorrerlas en orden sin ordenar numéricamente claves de texto (que, si no, quedan 1, 10, 100, 11). Y cada respuesta trae un count, así que una consulta de una sola entrada se distingue de una descarga completa sin mirar el contenido.

No cambia nada de lo que ya existía

/api/astro/chakra/ no se ha tocado. Sigue sirviendo los cuatro conjuntos de datos a través de su campo keys, sigue devolviendo la misma forma {key: data} y sigue devolviendo 400 para sai_prashnavali sin número. Si ya lo tienes integrado, nada de esto te afecta: son rutas adicionales, no un reemplazo.

Nombres nuevos en la referencia

«KP (Krishnamurti) chart» y «Krishnamurti paddhati» pasan a llamarse «KP chart (cusps, signs and planets)» y «KP parts (pick with keys)»: el primero te da la carta completa y el segundo te pide que indiques las partes que quieres. «House lord placements» y «House lord placement», que se diferenciaban en una letra, ahora son «(all 144)» y «(one pair)». Dos endpoints que se llamaban los dos «Pancha Pakshi» ahora son «(bird activity by hora)» y «(day in ten yamas)». «Birth panchanga effects» y «Birth panchanga readings» ahora son «(reference table)» y «(your elements)».

Las rutas no cambian

Solo cambian los nombres que se muestran en la documentación. Las rutas, los campos de la solicitud y los de la respuesta siguen exactamente igual: no tienes que tocar nada en tu integración. Si guardaste una página de la documentación en marcadores, la URL sigue funcionando; solo es más claro el título.

Capturas en las páginas de referencia

43 páginas de endpoint incluyen ahora una captura con los datos de ese endpoint en una interfaz real: panchang, choghadiya, el calendario de festivales, retrogradaciones, once calendarios regionales, cartas natales y más. Una tabla de campos te dice cómo es la respuesta, pero no para qué sirve, y con un vistazo sueles saber si es el endpoint que buscas. El índice de la documentación y la página de inicio muestran las mismas capturas.

Qué ha cambiado

/api/astro/chart/ acepta ahora un campo opcional, render. Si no lo envías, no cambia nada: la respuesta es exactamente la de siempre. Si lo pones a "svg", aparecen dos campos más junto a los cuatro habituales: layout (para cada casilla de casa o de signo, los puntos de su polígono, la posición de la etiqueta y qué planetas la ocupan) y svg (el código ya generado, para pegarlo directamente en una página). chart_style elige el estilo del norte de la India (el rombo, con casas fijas y signos que rotan) o del sur (la cuadrícula de signos fija, con casas que rotan); svg_size, theme, label_style, show_degrees y cuatro campos *_color controlan el aspecto.

Por qué importa

Dibujar una carta a partir de las longitudes en bruto da mucho trabajo (geometría de las casas, rotación de los signos, colocación de las etiquetas), y cada integrador lo estaba haciendo desde cero. Ahora es un campo más en una llamada que ya hacías. La geometría de layout está ahí para quien dibuje de forma nativa en React, Canvas, Flutter o SwiftUI en lugar de usar nuestro SVG.

No cambia nada de lo que ya existía

render vale "none" por defecto, y todos los demás campos nuevos tienen por defecto un valor que no hace nada. Una solicitud que no mencione ninguno recibe una respuesta idéntica byte a byte a la de antes de este cambio; lo comprobamos con todos los tipos de carta y todas las opciones que acepta el endpoint.

Dashas que se pueden buscar

Ya calculábamos treinta sistemas de dasha (once dashas de nakshatra y diecinueve de rashi, cada uno con varios niveles de anidación), pero eran valores de una cadena dasha_type en dos endpoints llamados nakshatra_dasha y raasi_dasha. Quien buscaba «vimshottari dasha» no encontraba nada. Ahora hay rutas con nombre: /api/astro/dasha/vimshottari/, /yogini/, /ashtottari/, /chara/, /narayana/, /kalachakra/ y más, además de /api/astro/dasha/systems/, que lista todos los sistemas con el endpoint de cada uno. Los dos endpoints originales no se han tocado y siguen funcionando.

Qué dasha está en curso ahora mismo

/api/astro/dasha/current/ responde a la pregunta que los endpoints de línea de tiempo no podían responder: devuelve la cadena desde el mahadasha hacia abajo («Jupiter / Ketu / Mercury»), con el inicio y el fin de cada nivel, cuánto llevas de él y cuántos días quedan. Antes, para eso había que descargar el árbol entero, recorrerlo y comparar fechas en tu propio código.

Astrología occidental tradicional y helenística

/api/astro/traditional/dignities/ devuelve domicilio, exaltación, triplicidad, término y faz de cada planeta, con la puntuación de Lilly; /almuten/ da el planeta con más dignidad sobre cada punto de la carta; /sect/ indica si una carta es diurna o nocturna y qué se deriva de ello; /profections/ da la profección anual, mensual y diaria, con el Señor del Año. Son tropicales, como exige la doctrina, y la respuesta indica qué tablas de términos y triplicidades se han usado: las fuentes no coinciden, y una puntuación calculada con otra tabla es otro número.

Cartas derivadas y la Luna

Cartas dracónicas, armónicas, de antiscia, heliocéntricas y Davison en /api/astro/western/, además de /api/astro/lunar/void-of-course/ y /api/astro/lunar/mansions/. La Luna fuera de curso no es una foto fija, sino una búsqueda hacia delante: recorre el tiempo hasta que la Luna cambia de signo, indica cada aspecto que se perfeccionará y cuándo exactamente, y te dice cuándo empieza y termina el periodo fuera de curso.

Los Cuatro Pilares chinos

/api/astro/chinese/four-pillars/, /bazi/, /zodiac/ y /luck-pillars/. El año chino empieza en Lichun, hacia el 4 de febrero; no empieza el 1 de enero ni en el Año Nuevo chino, que es una fecha lunar y marca la fiesta, no la carta. Un nacimiento del 20 de enero de 2024 da Conejo de Agua, no Dragón de Madera. Tanto el criterio de límite del día como el de hora solar verdadera son campos de la solicitud, porque cada astrólogo usa el suyo y cada uno cambia la carta.

Tarot

/api/astro/tarot/draw/, /spread/, /yes-no/ y /deck/. Cada tirada devuelve la semilla que la generó, y si vuelves a enviar esa semilla obtienes exactamente la misma tirada: mismas cartas, mismo orden, misma orientación. Así puedes guardar una lectura y volver a mostrarla, en vez de darle al consultante otra respuesta a la misma pregunta. Seis tiradas con nombre, hasta la Cruz Celta de diez cartas, con cada posición identificada.

Otras novedades

/api/astro/eclipse/visibility-path/ traza dónde es total un eclipse de sol, como coordenadas que puedes dibujar en un mapa, con el punto de máximo eclipse y su serie de Saros. Otros nueve endpoints ofrecen por separado cálculos para los que antes había que saber qué claves pedir a un endpoint más grande: prastara y sodhana del ashtakavarga, aspectos y yogas tajika, coordenadas horizontales y ecuatoriales de los planetas, iluminación de la Luna, segmentos vasa y cazimi.

No cambia nada de lo que ya existía

Todos los endpoints añadidos son rutas nuevas. No se ha modificado ningún cuerpo de solicitud, forma de respuesta ni nombre de campo de ningún endpoint existente, y no se ha eliminado ni renombrado ninguno. Los precios no cambian: cada llamada correcta cuesta un crédito, devuelva lo que devuelva.

Qué ha cambiado

Endpoints como /api/astro/sunrise/, /api/astro/tithi/, /api/astro/navamsa/ y /api/astro/rahu-kaal/ reciben los campos de nacimiento o de fecha de siempre y devuelven solo lo que indica su nombre. Los endpoints combinados que ya existían no cambian y siguen funcionando exactamente igual.

Por qué importa

Para mostrar la hora de salida del sol ya no hace falta pedir, pagar y procesar una respuesta de panchang completa. Respuestas más pequeñas, menos código para extraer los datos y un cuerpo de solicitud que se entiende de un vistazo.

Cómo empezar

Explora la referencia y envía la solicitud de ejemplo con tu clave en la cabecera X-API-Key. Los precios no cambian: cada llamada correcta cuesta un crédito, devuelva lo que devuelva.

Qué ha cambiado

La búsqueda encuentra funciones, no solo nombres de endpoint. Si escribes «manglik», encuentras el endpoint de doshas aunque su nombre no incluya la palabra «manglik», y el resultado te dice qué campo coincide.

Por qué importa

Detrás de la lista de endpoints hay varios cientos de campos. Sin poder buscar por nombre de campo, encontrar el que necesitabas obligaba a abrir los endpoints uno a uno y leer sus respuestas.

Qué ha cambiado

El servidor MCP occult-api ofrece como herramientas la búsqueda de endpoints, sus descripciones y las llamadas. Configúralo con tu clave de API y un asistente podrá encontrar el endpoint adecuado y llamarlo directamente.

Por qué importa

Es la forma más rápida de probar la API con una pregunta real antes de ponerte a construir nada, y de paso sirve como implementación de referencia, que funciona, del formato de las solicitudes.

Qué ha cambiado

La página de cada endpoint enlaza directamente con el Playground, con la solicitud de ejemplo ya rellenada. Cambia la latitud, la fecha o el ayanamsa y vuelve a enviarla.

Por qué importa

Leer una respuesta de ejemplo te dice cómo son los datos. Enviar tus propios datos te dice si responden a tu pregunta.

Qué ha cambiado

Crea una cuenta, genera una clave y envíala en la cabecera X-API-Key. Los créditos se descuentan por cada llamada correcta: una solicitud fallida nunca se cobra.

Por qué importa

No hay que estudiar una lista de precios por endpoint. Los cálculos usan las efemérides del JPL de la NASA, con todo el conjunto de ayanamsas clásicos y modernos.