POST/api/astro/pdf/yearbook/25 créditos

Informe PDF del anuario

Los próximos doce meses en un PDF listo para entregar, divididos por periodos de dasha. El cuerpo de la respuesta ES el PDF (`application/pdf`): una sola llamada y nada almacenado. /api/astro/pdf/horoscope/ describe una natividad; este describe un año de ella. El horóscopo es el mismo documento tanto si lo generas hoy como dentro de diez años; este, en cambio, está ligado a una fecha y caduca: si lo vuelves a generar el año que viene, todas las páginas serán distintas. EL AÑO NO SE DIVIDE EN MESES DEL CALENDARIO. Se divide por los pratyantardashas del Vimshottari, el tercer nivel del árbol de dashas, así que cada sección empieza y termina en una fecha que marca esta carta. Por eso un periodo puede durar tres semanas o dos meses, y el primero y el último suelen salirse del intervalo de doce meses, porque cada periodo se imprime entero o no se imprime. Cada periodo se interpreta en cuanto a finanzas, carrera profesional, vida familiar, amor y vida conyugal, y salud, con qué hacer, qué evitar y los remedios tradicionales para el graha de ese periodo. Si un periodo se presenta como favorable o exigente depende de la dignidad, la casa y la naturaleza funcional del graha regente EN ESTA CARTA, y los motivos se imprimen junto al veredicto, así que dos personas en el mismo periodo de Venus no reciben la misma página. DETERMINISTA. Cada párrafo se toma de una tabla, no se genera: los mismos datos de nacimiento y la misma `start_date` producen un libro idéntico byte a byte, y eso es lo que permite responder a una consulta de soporte. `start_date` es por defecto la fecha de hoy. Pasa el próximo cumpleaños del nativo para obtener un libro de cumpleaños a cumpleaños en lugar de uno que empiece hoy. Recibe los mismos datos de nacimiento y el mismo bloque opcional `branding` que el informe del horóscopo. Conviene leer dos cabeceras de respuesta: `X-Report-Periods` indica en cuántos periodos de dasha se dividió el año, para que distingas un libro completo de uno incompleto sin abrirlo, y `X-Report-Sections-Failed` cuenta los cálculos que no se pudieron completar.

https://api.occultapi.com/api/astro/pdf/yearbook/

Probar solicitud

Autenticación

Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
latitude	number (double)	obligatorio	Latitud del lugar, en grados decimales. Los valores positivos indican el norte y los negativos, el sur. Ejemplo: 26.9124 para Jaipur, 40.7128 para Nueva York. No se aceptan minutos ni segundos: conviértelos antes. min -90 · max 90
longitude	number (double)	obligatorio	Longitud del lugar, en grados decimales. Los valores positivos indican el este y los negativos, el oeste. Ejemplo: 75.7873 para Jaipur, -74.0060 para Nueva York. Cuidado con el signo: si falta el menos, Nueva York acaba en China. min -180 · max 180
ayanamsa	string	opcional
branding	object	opcional	Datos del revendedor impresos en la portada, el encabezado y el pie de página.
date_time	string (date-time)	opcional	El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC, y puede devolver con un 200 el resultado del día anterior. '2026-09-01T06:00:00Z' y '2026-09-01 06:00:00' son instantes distintos y dan respuestas distintas.
day	integer	opcional	Día del mes como número, 1-31. min 1 · max 31
gender	string	opcional
hour	integer	opcional	Hora de nacimiento en formato de 24 horas, 0-23. Hora local del lugar de nacimiento. min 0 · max 23
minute	integer	opcional	min 0 · max 59
month	integer	opcional	Mes de nacimiento como número, 1-12. Enero es 1. min 1 · max 12
name	string	opcional
place	string	opcional
start_date	string (date)	opcional	Primer día de los doce meses que abarca el informe, YYYY-MM-DD. Valor por defecto: hoy. Pasa el próximo cumpleaños del nativo para obtener un libro de cumpleaños a cumpleaños en lugar de uno que empiece hoy.
timezone_as_float	number (double)	opcional	Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. min -12 · max 14
year	integer	opcional	Año de nacimiento como número, p. ej., 1990. Cuatro dígitos. min 1800 · max 2200

Ejemplo de solicitud

curl -X POST https://api.occultapi.com/api/astro/pdf/yearbook/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"Ajeet Kanojia","gender":"male","date_time":"1985-02-23T05:45:00+05:30","latitude":20.8833,"longitude":76.2,"timezone_as_float":5.5,"place":"Malkapur, Maharashtra, India","start_date":"2026-01-01","branding":{"company_name":"Acme Astrology","company_info":"Vedic reports since 2011.","company_email":"hello@acme.example","domain_url":"https://acme.example","footer_link":"acme.example"}}'

Respuesta

Errores

Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.