API Human Design : construire des applications HD sur 12 endpoints

🕓 Note du 2026-04-14, mise à jour le 2026-05-09. Les SDK TS / Python / PHP sont maintenant disponibles sur les registres publics - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist). Détails dans le changelog.

Le Design Humain est passé d’un système ésotérique de niche dans les années 1990 à un cadre de développement personnel mainstream. Les applications avec des millions d’utilisateurs l’ont normalisé - et les développeurs se demandent : comment calculer la carte de Design Humain de manière programmatique ?

Dans cet article, nous allons explorer le côté technique : qu’est-ce que le calcul de Design Humain, quels API le prennent en charge et comment intégrer la fonctionnalité de Design Humain dans ton application.

Le Design Humain est basé sur trois systèmes classiques :

• L’astrologie occidentale - les positions des planètes au moment de la naissance
• Le I Ching - 64 hexagrammes, cartographiés sur 64 « portes »
• Le 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 avec :

• Type (Manifestor, Générateur, Générateur manifestant, Projecteur, Réfléchisseur) - signature énergétique
• Stratégie - comment prendre des décisions
• Autorité - quel centre faire confiance pour les décisions (Sacré, Émotionnel, Splénique, etc.)
• Profil - combinaison de lignes (1/3, 4/6, etc.)
• Canaux - liens entre les centres, formant la personnalité
• Croix d’incarnation - objectif 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 tes planètes à la naissance est cartographiée sur des portes spécifiques (et des lignes à l’intérieur). Le calcul du « Design » - pour un décalage du Soleil de 88° avant la naissance - environ 3 mois plus tôt.

Le Design Humain utilise deux points de naissance :

1. Personnalité - l’heure réelle de naissance. C’est le « côté conscient ».
2. Design - lorsque le Soleil était à 88° avant la position de naissance. C’est le « côté inconscient ».

Chaque activation de porte appartient à l’un d’eux. La carte complète comporte 13 + 13 = 26 activations.

C’est ce qui rend le calcul de Design Humain plus difficile que la carte astrologique standard - tu calculles en fait deux cartes.

La plupart des API d’astrologie ne prennent pas en charge le Design Humain ou ont une prise en charge superficielle (seulement type + stratégie). Une implémentation complète de Design Humain nécessite :

• Une cartographie des 64 portes (table de recherche)
• 6 lignes pour chaque porte (384 cellules)
• 9 centres avec une logique définie/ouverte
• 36 canaux (chaque canal relie deux centres)
• Calcul de la Croix d’incarnation
• Affichage du Profil avec la ligne de la porte du Soleil + la ligne de la porte de la Terre (Personnalité et Design)

Les API qui peuvent tout cela sont rares. L’API AstroWay a 12 points de terminaison de Design Humain - la couverture la plus profonde que nous ayons vue dans une API commerciale.

Imagine que tu ajoutes le Design Humain à une application astrologique existante. Commence par le point de terminaison 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}`);         // наприклад, "Generator"
console.log(`Strategy: ${hd.strategy}`); // наприклад, "To Respond"
console.log(`Authority: ${hd.authority}`); // наприклад, "Sacral"
console.log(`Profile: ${hd.profile.profile}`);   // наприклад, "1/3"
console.log(`Defined channels: ${hd.channels.length}`);

Format de 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 les groupes de 3 à 5 personnes. C’est une rareté - la plupart des calculateurs de Design Humain ne l’offrent pas. Mais c’est de l’or pour les plateformes de ressources humaines, les plateformes de coaching et les applications de construction d’équipe.

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 de Design Humain sont sensibles à l’heure de naissance. Une erreur de 10 minutes peut changer le Profil (par exemple, 1/3 → 1/4). Pour les utilisateurs qui ne connaissent pas l’heure exacte, exécutez l’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 покаже, які поля зміняться при зсуві часу на ±5/15/30 хв

Utilisez-le pour avertir l’utilisateur : « À cette précision, ton profil peut changer. Envisage la rectification ».

Si tu construis une application axée sur le Design Humain :

• Utilisateur de base : 1 carte de Design Humain lors de l’inscription, mise en cache à vie = 50 crédits une fois
• Utilisateur actif : transits périodiques + compatibilité = ~200 crédits/mois
• 100 DAU avec une utilisation modérée de Design Humain : ~110 000 crédits/mois → Starter (19 $/mois) couvre facilement
• 1 000 DAU : ~150 000 crédits/mois → Pro (59 $/mois)

Les demandes de compatibilité sont les plus coûteuses (100 crédits). Mettez en cache les résultats pour chaque paire d’utilisateurs à vie (ils sont immuables).

Le rendu du bodygraph est traditionnellement effectué via SVG. L’API retourne les données sur les centres et les canaux ; tu rends la visualisation. 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 sont un modèle fixe (chaque bodygraph a les mêmes 9 centres et 64 portes aux mêmes positions).

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