API de Diseño Humano: crea aplicaciones HD con 12 endpoints

🕓 Entrada del 2026-04-14, actualizado 2026-05-09. TS / Python / PHP SDK ahora viven en public registries — @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Detalles en changelog.

Human Design ha crecido desde un sistema esotérico de nicho en la década de 1990 hasta un marco de desarrollo personal mainstream. Aplicaciones con millones de usuarios lo han normalizado — y los desarrolladores se preguntan: ¿cómo calcular el mapa de Human Design de forma programática?

En este post — el lado técnico: ¿qué es el cálculo de HD, qué API lo soportan y cómo integrar la función de HD en tu aplicación?

Human Design se basa en tres sistemas clásicos:

• Astrología occidental — posiciones de los planetas en el momento del nacimiento
• I Ching — 64 hexagramas, mapeados en 64 “puertas”
• Sistema de chakras — nueve “centros” (nodos energéticos)

El cálculo toma los datos de nacimiento y produce un bodygraph — un mapa visual con:

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) — firma energética
• Strategy — cómo tomar decisiones
• Authority — qué centro confiar en las decisiones (Sacral, Emotional, Splenic, etc.)
• Profile — combinación de líneas (1/3, 4/6, etc.)
• Channels — conexiones entre centros que forman la personalidad
• Incarnation Cross — propósito de la vida, derivado de cuatro posiciones clave

Bajo el capó, cada una de las 64 puertas corresponde a un rango de longitud eclíptica. La longitud de tus planetas en el nacimiento se mapea en puertas específicas (y filas dentro de ellas). El cálculo del “Diseño” — para el desplazamiento del Sol a 88° antes del nacimiento — aproximadamente 3 meses antes.

Human Design utiliza dos puntos de nacimiento:

1. Personality — hora real de nacimiento. Este es el lado “consciente”.
2. Design — cuando el Sol estaba a 88° antes de la posición de nacimiento. Este es el lado “inconsciente”.

Cada activación de la puerta pertenece a uno de ellos. El mapa completo tiene 13 + 13 = 26 activaciones.

Es precisamente esto lo que hace que el cálculo de HD sea más difícil que un mapa astrológico estándar — estás calculando dos cartas.

La mayoría de las API de astrología no soportan HD o tienen un soporte superficial (solo tipo + estrategia). Una implementación completa de HD requiere:

• Mapeo de 64 puertas (tabla de búsqueda)
• 6 líneas por cada puerta (384 celdas)
• 9 centros con lógica definida/abierta
• 36 canales (cada uno conecta dos centros)
• Cálculo de Incarnation Cross
• Salida de Profile con la línea de la puerta del Sol + la línea de la puerta de la Tierra (Personality y Design)

Las API que pueden hacer todo esto son una gran rareza. AstroWay API tiene 12 puntos finales de HD — la cobertura más profunda que hemos visto en una API comercial.

Imagina que estás agregando HD a una aplicación astrológica existente. Comienza con el punto final principal:

import { Astroway } from '@astroway/sdk';

const client = new Astroway({ apiKey: process.env.ASTROWAY_API_KEY! });

const hd = await client.humanDesign({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

console.log(`Type: ${hd.type}`);         // por ejemplo, "Generator"
console.log(`Strategy: ${hd.strategy}`); // por ejemplo, "To Respond"
console.log(`Authority: ${hd.authority}`); // por ejemplo, "Sacral"
console.log(`Profile: ${hd.profile}`);   // por ejemplo, "1/3"
console.log(`Defined channels: ${hd.channels.length}`);

La forma de la respuesta:

{
  "type": "Generator",
  "strategy": "To Respond",
  "notSelfTheme": "Frustration",
  "authority": "Sacral",
  "profile": "1/3",
  "definition": "single",
  "cross": {
    "name": "Right Angle Cross of the Sphinx",
    "quarter": "Civilization",
    "gates": [1, 2, 7, 13]
  },
  "centers": [
    { "name": "Sacral", "defined": true },
    ...
  ],
  "channels": [
    { "gate1": 34, "gate2": 20, "name": "Channel of Charisma", "type": "Generated" }
  ],
  "personalityActivations": [...],
  "designActivations": [...]
}

Penta es una técnica para comprender la dinámica del equipo en grupos de 3-5 personas. Es una rareza — la mayoría de los calculadores de HD no la ofrecen. Pero es oro para HR-tech, plataformas de coaching y aplicaciones de teambuilding.

const penta = await client.hdPenta({
  members: [
    { date: '1990-07-14', time: '14:30:00', timezoneOffset: 3, latitude: 50.45, longitude: 30.52 },
    { date: '1988-03-10', time: '08:15:00', timezoneOffset: 2, latitude: 48.85, longitude: 2.35 },
    { date: '1985-11-22', time: '18:00:00', timezoneOffset: -5, latitude: 40.71, longitude: -74.00 },
  ],
});

console.log(`Penta type: ${penta.type}`);
console.log(`Defined channels in group: ${penta.definedChannels.length}`);

Los mapas de HD son sensibles al tiempo de nacimiento. Un error de 10 minutos puede cambiar el Perfil (por ejemplo, 1/3 → 1/4). Para los usuarios que no conocen el tiempo exacto, ejecuta el análisis de sensibilidad:

const sensitivity = await client.hdSensitivity({
  date: '1990-07-14',
  time: '14:30:00',
  timezoneOffset: 3,
  latitude: 50.4501,
  longitude: 30.5234,
});

// sensitivity mostrará qué campos cambiarán al desplazar el tiempo en ±5/15/30 minutos

Utiliza esto para advertir al usuario: “En esta precisión, tu perfil puede cambiar. Considera la rectificación”.

Si estás construyendo una aplicación enfocada en HD:

• Usuario básico: 1 mapa de HD al registrarse, en caché para siempre = 50 créditos de una sola vez
• Usuario activo: tránsitos periódicos + compatibilidad = ~200 créditos/mes
• 100 DAU con uso moderado de HD: ~110 000 créditos/mes → Starter ($19/mes) cubre fácilmente
• 1 000 DAU: ~150 000 créditos/mes → Pro ($59/mes)

Las solicitudes de compatibilidad son las más difíciles (100 créditos). Almacena en caché los resultados para cada par de usuarios para siempre (son inmutables).

La representación del bodygraph se hace tradicionalmente a través de SVG. La API devuelve los datos sobre los centros y los canales; tú renderizas la visualización. Ejemplo:

function Bodygraph({ hd }: { hd: HDChart }) {
  return (
    <svg viewBox="0 0 400 600">
      {hd.centers.map(c => (
        <polygon
          key={c.name}
          points={CENTER_COORDS[c.name]}
          fill={c.defined ? CENTER_COLORS[c.name] : 'white'}
          stroke="black"
        />
      ))}
      {hd.channels.map(ch => (
        <line
          key={`${ch.gate1}-${ch.gate2}`}
          x1={GATE_COORDS[ch.gate1].x}
          y1={GATE_COORDS[ch.gate1].y}
          x2={GATE_COORDS[ch.gate2].x}
          y2={GATE_COORDS[ch.gate2].y}
          stroke="#d4a84c"
          strokeWidth="3"
        />
      ))}
    </svg>
  );
}

Las coordenadas son un patrón fijo (cada bodygraph tiene los mismos 9 centros y 64 puertas en las mismas posiciones).

• Human Design API — página de producto con la lista completa de puntos finales
• Ejemplo: Human Design — walkthrough detallado de /v1/human-design
• Inicio rápido — obtén una clave de API gratuita (hasta 200 mapas de HD/mes en Free)