Renderizado de Cartas

Generasd hermosas imágenes de cartas en SVG y PNG.

Cartas SVG

Generasd una carta natal en SVG usando parámetros de consulta:

curl -X GET "https://api.astroapi.cloud/api/chart/image.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key"

Cartas PNG

Convertid al formato PNG:

curl -X GET "https://api.astroapi.cloud/api/chart/image.png?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key" \
  --output chart.png

Tipos de Carta

Endpoint	Descripción
/api/chart/image.svg	Carta natal en SVG
/api/chart/image.png	Carta natal en PNG
/api/chart/image.svg con parámetros transit.*	Carta bi-rueda de tránsito
/api/chart/composite.svg	Carta compuesta (puntos medios)
/api/chart/composite.png	Carta compuesta en PNG

Carta Bi-rueda de Tránsito

Añadid parámetros de tránsito para renderizar una carta bi-rueda con la rueda natal (interior) y la rueda de tránsito (exterior):

curl -X GET "https://api.astroapi.cloud/api/chart/image.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=-0.1278&location.latitude=51.5074&location.timezone=Europe/London&transit.dateTime=2024-01-15T12:00&transit.timezone=Europe/London" \
  -H "X-Api-Key: your-api-key"

Parámetros de Tránsito

Parámetro	Obligatorio	Descripción
transit.dateTime	Sí	Fecha/hora del tránsito (YYYY-MM-DDTHH:mm)
transit.timezone	Sí	Zona horaria del tránsito
transit.longitude	No	Longitud de la ubicación del tránsito (por defecto: natal)
transit.latitude	No	Latitud de la ubicación del tránsito (por defecto: natal)

Carta Compuesta

Generasd una carta compuesta que muestra los puntos medios entre dos cartas natales:

curl -X GET "https://api.astroapi.cloud/api/chart/composite.svg?width=800&height=800&person1.dateTime=1990-06-15T14:30&person1.timezone=Europe/London&person1.longitude=-0.1278&person1.latitude=51.5074&person2.dateTime=1988-03-22T09:15&person2.timezone=Europe/Paris&person2.longitude=2.3522&person2.latitude=48.8566" \
  -H "X-Api-Key: your-api-key"

Parámetros de Consulta

Parámetros de Carta Natal

Parámetro	Obligatorio	Descripción
width	Sí	Ancho de la carta en píxeles
height	Sí	Alto de la carta en píxeles
dateTime	Sí	Fecha/hora de nacimiento (YYYY-MM-DDTHH:mm)
location.longitude	Sí	Longitud del lugar de nacimiento
location.latitude	Sí	Latitud del lugar de nacimiento
location.timezone	Sí	Zona horaria del lugar de nacimiento (formato IANA)

Parámetros de Carta Compuesta

Parámetro	Obligatorio	Descripción
width	Sí	Ancho de la carta en píxeles
height	Sí	Alto de la carta en píxeles
person1.dateTime	Sí	Fecha/hora de nacimiento de la persona 1
person1.timezone	Sí	Zona horaria de la persona 1
person1.longitude	Sí	Longitud de la persona 1
person1.latitude	Sí	Latitud de la persona 1
person2.dateTime	Sí	Fecha/hora de nacimiento de la persona 2
person2.timezone	Sí	Zona horaria de la persona 2
person2.longitude	Sí	Longitud de la persona 2
person2.latitude	Sí	Latitud de la persona 2

Cabeceras de Respuesta

Los endpoints de cartas devuelven los tipos de contenido apropiados:

• SVG: image/svg+xml
• PNG: image/png

Incrustar Cartas

Usad el SVG devuelto directamente en HTML:

<div class="chart-container">
  <!-- Contenido SVG de la API -->
</div>

O usadlo como fuente de imagen con URL de datos:

<img src="data:image/svg+xml;base64,..." alt="Carta Natal" />

Chart2 — Motor de Cartas de Nueva Generación

AstroAPI ofrece un motor de renderizado de cartas de nueva generación con soporte de temas y animaciones.

Endpoints

Endpoint	Descripción	Módulo Requerido
/api/chart2/natal.svg	Carta natal (SVG)	module:natal-calc
/api/chart2/natal.png	Carta natal (PNG)	module:natal-calc
/api/chart2/transit.svg	Bi-rueda de tránsito (SVG)	module:transit-calc
/api/chart2/transit.png	Bi-rueda de tránsito (PNG)	module:transit-calc
/api/chart2/synastry.svg	Carta de sinastría (SVG)	module:synastry-calc
/api/chart2/synastry.png	Carta de sinastría (PNG)	module:synastry-calc
/api/chart2/composite.svg	Carta compuesta (SVG)	module:synastry-calc
/api/chart2/composite.png	Carta compuesta (PNG)	module:synastry-calc
/api/chart2/animated-transit.svg	Tránsito animado (SVG)	module:transit-calc

Uso Básico

curl -X GET "https://api.astroapi.cloud/api/chart2/natal.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=4.89&location.latitude=52.37&location.timezone=Europe/Amsterdam&theme=dark" \
  -H "X-Api-Key: your-api-key"

Temas Predefinidos

Tema	Descripción
default	Fondo blanco clásico con elementos de colores
classic	Aspecto astrológico tradicional
dark	Tema oscuro moderno con colores vibrantes
minimal	Limpio, con menos ruido visual
colorful	Colores planetarios vivos
nextgen	Moderno con líneas de aspectos curvas, efectos de brillo y degradados
vintage	Estilo de pergamino/manuscrito antiguo con tonos sépia
neon	Cyberpunk con colores neón brillantes sobre negro
pastel	Colores pastel suaves y tranquilizadores
print	Alto contraste en blanco/negro, optimizado para impresión

Sobreescrituras de Tema

Personalizad propiedades individuales del tema mediante parámetros de consulta:

Parámetro	Descripción
theme.background	Color de fondo (hex)
theme.foreground	Color de primer plano (hex)
theme.strokeOnly	Modo solo trazo (true/false)
theme.symbolScale	Factor de escala de símbolos
theme.showDegrees	Mostrar etiquetas de grados (true/false)
theme.showHouseNumbers	Mostrar números de casas (true/false)
theme.showRuler	Mostrar regla (true/false)
theme.signBackgroundOpacity	Opacidad del fondo del signo (0-1)

Cartas de Sinastría y Compuesta

curl -X GET "https://api.astroapi.cloud/api/chart2/synastry.svg?width=800&height=800&person1.dateTime=1990-06-15T14:30&person1.timezone=Europe/Amsterdam&person1.longitude=4.89&person1.latitude=52.37&person2.dateTime=1992-03-20T09:15&person2.timezone=Europe/London&person2.longitude=-0.12&person2.latitude=51.50" \
  -H "X-Api-Key: your-api-key"

Tránsito Animado

Generasd un SVG animado que muestra la progresión del tránsito a lo largo del tiempo:

curl -X GET "https://api.astroapi.cloud/api/chart2/animated-transit.svg?width=800&height=800&dateTime=1990-06-15T14:30&location.longitude=4.89&location.latitude=52.37&location.timezone=Europe/Amsterdam&transit.dateTime=2025-01-01T12:00&transit.timezone=Europe/Amsterdam&target.dateTime=2025-12-31T23:59&animation.duration=3000" \
  -H "X-Api-Key: your-api-key"

Parámetro	Descripción
target.dateTime	Fecha de fin de la animación
animation.duration	Duración de la animación en milisegundos
animation.easing	Función de suavizado (por defecto: easeInOut)
animation.loop	Repetir la animación en bucle (por defecto: false)