Human Design API : créez des applications HD avec 12 endpoints

🕓 Article du 2026-04-14, mis à jour le 2026-05-09. Les SDK TS / Python / PHP sont désormais publiés sur les registres publics - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Détails dans le changelog.

Le Human Design est passé d’un système ésotérique de niche des années 1990 à un cadre grand public de développement personnel. Des applications comptant des millions d’utilisateurs l’ont banalisé, et les développeurs se posent la question : comment calculer une carte Human Design par programmation ?

Cet article aborde le côté technique : en quoi consistent les calculs HD, quelles API les prennent en charge et comment intégrer une fonctionnalité HD dans votre application.

Le Human Design repose sur trois systèmes classiques :

• Astrologie occidentale : positions des planètes au moment de la naissance
• I Ching : 64 hexagrammes, associés à 64 “portes”
• Système des chakras : neuf “centres” (nœuds énergétiques)

Le calcul prend les données de naissance et produit un bodygraph, une carte visuelle comprenant :

• Type (Manifestor, Generator, Manifesting Generator, Projector, Reflector) : la signature énergétique
• Strategy : comment prendre des décisions
• Authority : à quel centre se fier pour décider (Sacral, Emotional, Splenic, etc.)
• Profile : combinaison de lignes (1/3, 4/6, etc.)
• Channels : liaisons entre centres qui façonnent la personnalité
• Incarnation Cross : le but de vie, dérivé de quatre positions clés

Sous le capot, chacune des 64 portes correspond à une plage de longitude écliptique. La longitude de vos planètes à la naissance est associée à des portes précises (et aux lignes à l’intérieur de celles-ci). Le calcul “Design” correspond au moment où le Soleil se trouvait 88° avant sa position de naissance, soit environ 3 mois plus tôt.

Le Human Design utilise deux instants de naissance :

1. Personality : l’heure de naissance réelle. C’est la part “consciente”.
2. Design : le moment où le Soleil était à 88° de sa position de naissance. C’est la part “inconsciente”.

Chaque activation de porte appartient à l’une des deux. Une carte complète compte 13 + 13 = 26 activations.

C’est ce qui rend le calcul HD plus lourd qu’un thème astral classique : vous calculez en réalité deux cartes.

La plupart des API d’astrologie ne prennent pas du tout en charge le HD, ou seulement de façon superficielle (type + strategy). Une implémentation HD complète exige :

• La correspondance des 64 portes (table de lookup)
• 6 lignes par porte (384 cellules)
• 9 centres avec la logique defined/open
• 36 canaux (chacun reliant deux centres)
• Le calcul de l’Incarnation Cross
• La déduction du Profile à partir de la ligne de la porte du Soleil + de la ligne de la porte de la Terre (Personality et Design)

Les API capables de tout cela sont très rares. AstroWay API propose 12 endpoints HD, la couverture la plus complète que nous ayons vue dans une API commerciale.

Imaginez que vous ajoutez le HD à une application d’astrologie existante. Commencez par l’endpoint principal :

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

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

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

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

Forme de la réponse :

{
  "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 est une technique pour comprendre la dynamique d’équipe dans des groupes de 3 à 5 personnes. C’est rare : la plupart des calculateurs HD ne la proposent pas. Mais c’est de l’or pour la HR-tech, les plateformes de coaching et les applications de team building.

const penta = await client.hd.penta({
  inputs: [
    { 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(`Members: ${penta.memberCount}`);
console.log(`Channels in the group: ${penta.channels.length}`);

Les cartes HD sont sensibles à l’heure de naissance. Une erreur de 10 minutes peut changer le Profile (par exemple 1/3 → 1/4). Pour les utilisateurs qui ne connaissent pas leur heure exacte, lancez une analyse de sensibilité :

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

// sensitivity tells you which fields change if time shifts ±5/15/30 min

Servez-vous-en pour prévenir l’utilisateur : “Avec cette précision, votre profile peut changer. Envisagez une rectification.”

Si vous construisez une application centrée sur le HD :

• Utilisateur de base : 1 carte HD à l’inscription, mise en cache définitivement = 50 crédits une seule fois
• Utilisateur actif : transits réguliers + compatibility = ~200 crédits/mois
• 100 DAU avec un usage HD modéré : ~110 000 crédits/mois → Starter (19 $/mois) suffit largement
• 1 000 DAU : ~150 000 crédits/mois → Pro (59 $/mois)

Les requêtes de compatibility sont les plus lourdes (100 crédits). Mettez en cache le résultat de chaque paire d’utilisateurs pour toujours (il ne change pas).

Le rendu du bodygraph se fait traditionnellement en SVG. L’API renvoie les données des centres et des canaux, et vous rendez le visuel. Exemple :

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>
  );
}

Les coordonnées forment un gabarit fixe (chaque bodygraph a les mêmes 9 centres et 64 portes aux mêmes positions).

• Human Design API : page produit avec la liste complète des endpoints
• Exemple : Human Design : walkthrough détaillé de /v1/human-design
• Démarrage rapide : obtenez une clé API gratuite (jusqu’à 200 cartes HD/mois avec Free)