La API de astrología

Fiel a los textos clásicos

Las cartas y las lecturas siguen la tradición de Parashara tal como la enseñan el Brihat Parashara Hora Shastra, el Phaladeepika, el Saravali y el Jataka Parijata. La compatibilidad matrimonial ofrece el método de los diez porutham del sur de la India y el cómputo Ashtakoota del norte, y el Vastu sigue las dieciséis zonas y las cuarenta y cinco deidades del Vastu Purusha Mandala.

Tu clave

Envía tu clave en una cabecera de la petición en cada llamada. Solo guardamos una huella irreversible de la clave, así que conserva el secreto que te mostramos en un lugar seguro; si alguna vez se filtra, revócala y crea otra desde tu consola.

curl -H "X-API-Key: YOUR_KEY" \
  "https://YOUR_HOST/v1/astro/panchang/sunrise?date=20/10/2026&lat=13.0827&lon=80.2707&tz=5.5"

Catorce idiomas, cada uno en su propia escritura

Añade el parámetro de idioma a cualquier llamada. Planetas, signos, estrellas y cada lectura llegan en la escritura propia de ese idioma y con sus términos tradicionales, nunca mezclados con otra escritura.

lang = en | ta | te | kn | hi | ml | sa | bn | gu | es | mr | pa | or | ur

curl -H "X-API-Key: YOUR_KEY" \
  "https://YOUR_HOST/v1/astro/horoscope/planet-details?dob=11/03/1994&tob=11:40&lat=13.0827&lon=80.2707&tz=5.5&lang=ta"

Qué puedes consultar

Panchang para cualquier día y lugar, la carta natal con sus cartas divisionales, compatibilidad por porutham y por gunas, Vimshottari y otros dashas, revisión de doshas, horóscopos diarios a anuales, numerología y nociones de Vastu. La lista completa con cada parámetro está en la referencia de abajo y en la descripción descargable.

/v1/astro/panchang/...      panchang, sunrise, hora, choghadiya, festivals
/v1/astro/horoscope/...     planet-details, divisional-charts, ashtakvarga
/v1/astro/extended/...      extended-kundli-details, kp-planets, current-sade-sati
/v1/astro/matching/...      south-match (porutham), ashtakoot, dashakoot
/v1/astro/dashas/...        maha-dasha, antar-dasha, yogini-dasha-main, char-dasha-main
/v1/astro/dosha/...         mangal-dosh, kaalsarp-dosh, pitra-dosh
/v1/astro/prediction/...    daily-moon, weekly-moon, yearly, numerology
/v1/astro/utilities/...     radical-number-details, gem-details, geo-search
/v1/astro/vastu/zones       vastu basics
/v1/vastu/...               plot grid, entrance, score, ayadi

Informes completos en tres tamaños

Pide una lectura completa construida con nuestro banco de lecturas revisadas basado en reglas, o una narración con IA escrita sobre los mismos datos de la carta. Cada informe llega como texto estructurado, documento diseñado, lectura hablada o película de la carta, y cada uno en tamaño pequeño, mediano o detallado.

curl -X POST "https://YOUR_HOST/v1/astro/report/natal" \
  -H "X-API-Key: YOUR_KEY" -H "content-type: application/json" \
  -d '{"dob":"11/03/1994","tob":"11:40","lat":13.0827,"lon":80.2707,"tz":5.5,
       "lang":"hi","format":"pdf","size":"detailed"}'

format = json | pdf | audio | film
size   = small | medium | detailed
/v1/astro/report/{family}     rule based
/v1/astro/ai_report/{family}  AI narrative

El trabajo largo se ejecuta como tarea

Añade la opción asíncrona y la llamada responde al instante con un número de tarea. Consulta su estado cuando quieras, o danos una dirección y la llamaremos en cuanto el trabajo esté listo. Las lecturas habladas y las películas siempre funcionan así.

POST /v1/astro/ai_report/natal
{ ..., "format": "audio", "size": "medium", "async": true,
  "webhook_url": "https://example.com/hooks/astro" }

202 { "status": "ok", "response": { "job": { "id": "...", "status": "queued",
      "poll_url": "/v1/astro/jobs/..." } } }

GET /v1/astro/jobs/{id}   queued | running | rendering | done | failed

Avisos firmados

Cada aviso lleva una marca de tiempo y una firma hecha con el secreto propio de tu clave. Comprueba la firma antes de confiar en el mensaje y responde rápido con un código de éxito; si no puedes, lo intentamos de nuevo unas cuantas veces con pausas crecientes.

// Node.js
const crypto = require('crypto');
function verify(rawBody, headers, secret) {
  const ts = headers['x-webhook-timestamp'];
  const expected = 'v1=' + crypto.createHmac('sha256', secret)
    .update(ts + '.' + rawBody).digest('hex');
  const fresh = Math.abs(Date.now() / 1000 - Number(ts)) < 300;
  return fresh && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(headers['x-webhook-signature']));
}

Créditos y paquetes de créditos

Cada llamada usa primero los créditos de la asignación mensual de tu plan y después los de tus paquetes de créditos. Cada respuesta indica cuántos créditos usó y cuántos quedan, sin sorpresas.

X-Credits-Used: 8
X-Credits-Remaining: 9992

"meta": { "credits": 8, "remaining": 9992, "request_id": "..." }

Límites de uso justo

Cada clave tiene un límite por minuto según su plan. Si lo superas, la llamada se rechaza con amabilidad, con un código claro y una indicación de cuándo volver a intentarlo.

HTTP/1.1 429
Retry-After: 60
X-RateLimit-Limit: 60

{ "status": "error", "error": { "code": "rate_limited", "message": "..." } }

Reintentos seguros

Cuando envíes una petición que crea algo, añade tu propia clave única de petición. Si se corta la red y la envías de nuevo, recibes la primera respuesta y nunca se cobra dos veces.

curl -X POST "https://YOUR_HOST/v1/astro/report/match" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Idempotency-Key: order-2026-10-20-0001" \
  -d '{ ... }'

Idempotent-Replayed: true   (on a repeated request)

Una sola forma para cada error

Cada rechazo tiene la misma forma: un código breve con el que puedes actuar, un mensaje sencillo y, cuando ayuda, el nombre del parámetro que hay que corregir.

{
  "status": "error",
  "error": { "code": "param_missing", "message": "...", "param": "tob" },
  "meta": { "request_id": "..." }
}

Versiones estables

La versión forma parte de la dirección, así que tu integración sigue funcionando mientras crecemos. Pueden aparecer campos nuevos en las respuestas; cualquier cambio que pudiera romper tu código llega solo en una versión nueva.

https://YOUR_HOST/v1/astro/...
Api-Version: 1          (optional request header)
X-Api-Version: 1.0.0    (every answer)

El banco de lecturas

En los planes que lo incluyen, puedes leer todo nuestro banco de lecturas revisadas sección por sección y página por página, en todos los idiomas y completo, para crear tus propias experiencias.

GET /v1/astro/content/sections?lang=ta
GET /v1/astro/content/blocks?section=yogas&lang=ta&limit=100
GET /v1/astro/content/blocks?section=yogas&lang=ta&cursor=NEXT_CURSOR

Narración con IA, bien fundamentada

Los informes con IA se escriben solo a partir de la carta calculada y de las lecturas revisadas, y se comprueban en escritura y tono antes de llegar a ti. Los socios pueden usar nuestros modelos o traer la clave de su propio proveedor cuando su plan lo permite.

Descripción legible por máquina

Descarga la descripción completa para generar un cliente en tu lenguaje favorito o para explorar cada punto de acceso en la herramienta que ya usas.

GET https://YOUR_HOST/v1/astro/openapi.json
GET https://YOUR_HOST/v1/astro/catalog