# 휴먼 디자인 API

AstroWay API는 **12개의 Human Design 엔드포인트**를 제공합니다 — 상업용 API 중 가장 광범위한 HD 커버리지입니다. 기본 bodygraph부터 Penta 그룹 역학 및 Dream Rave까지.

## 계산되는 항목

완전한 HD 맵에는 다음이 포함됩니다:

- **타입** — Manifestor, Generator, Manifesting Generator, Projector, Reflector
- **전략** — 의사결정 메커니즘
- **권위** — 내부 권위 (Sacral, Emotional, Splenic, Ego, Self-Projected, Mental, Lunar)
- **프로파일** — 선 조합 (1/3, 2/4, 3/5, 4/6 등)
- **정의** — single, split, triple-split, quadruple-split
- **윤회 십자가** — 이름, 사분면, 4개의 문
- **센터** — 9개의 센터(defined/open 플래그 포함)
- **채널** — 정의된 채널과 이름
- **액티베이션** — 26개의 액티베이션(13 Personality + 13 Design)

## 12개의 엔드포인트

| 엔드포인트 | 크레딧 | 반환 값 |
|---|---|---|
| `/v1/human-design` | 50 | 완전한 HD 맵 |
| `/v1/human-design/transits` | 50 | 특정 날짜의 HD 트랜짓 |
| `/v1/human-design/compatibility` | 100 | 두 HD 맵의 호환성 |
| `/v1/hd/incarnation-cross` | 50 | 윤회 십자가 |
| `/v1/hd/dream-rave` | 50 | Dream Rave 맵(야간 디자인) |
| `/v1/hd/hologenetic` | 50 | Hologenetic 프로파일 |
| `/v1/hd/sensitivity` | 50 | 시간 민감도(출생 시간 변경 영향) |
| `/v1/hd/circuitry` | 20 | контур 분석(Individual, Tribal, Collective) |
| `/v1/hd/penta` | 100 | Penta — 3~5명의 그룹 역학 |
| `/v1/hd/group-overlay` | 100 | 그룹 오버레이 |
| `/v1/hd/design-date` | 10 | Design 날짜(출생 전 태양 88°) |
| `/v1/hd/rave-new-years` | 10 | Rave New Year 날짜 |

## 예시

<Tabs>
  <TabItem label="cURL">
    ```bash frame="terminal"
    curl -X POST https://api.astroway.info/v1/human-design \
      -H "X-Api-Key: aw_live_your_key_here" \
      -H "Content-Type: application/json" \
      -d '{
        "date": "1990-07-14",
        "time": "14:30:00",
        "timezoneOffset": 3,
        "latitude": 50.4501,
        "longitude": 30.5234
      }'
    ```
  </TabItem>
  <TabItem label="Node.js">
    ```ts
    const r = await fetch('https://api.astroway.info/v1/human-design', {
      method: 'POST',
      headers: {
        'X-Api-Key': process.env.ASTROWAY_API_KEY!,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        date: '1990-07-14',
        time: '14:30:00',
        timezoneOffset: 3,
        latitude: 50.4501,
        longitude: 30.5234,
      }),
    });
    const { data: hd } = await r.json();
    console.log(`${hd.type} — ${hd.strategy} — ${hd.authority}`);
    console.log(`Profile: ${hd.profile}, Channels: ${hd.channels.length}`);
    ```
  </TabItem>
  <TabItem label="Python">
    ```python

    r = requests.post(
        'https://api.astroway.info/v1/human-design',
        headers={'X-Api-Key': os.environ['ASTROWAY_API_KEY'], 'Content-Type': 'application/json'},
        json={
            'date': '1990-07-14',
            'time': '14:30:00',
            'timezoneOffset': 3,
            'latitude': 50.4501,
            'longitude': 30.5234,
        },
    )
    hd = r.json()['data']
    print(f"{hd['type']} — {hd['strategy']} — {hd['authority']}")
    print(f"Profile: {hd['profile']}, Channels: {len(hd['channels'])}")
    ```
  </TabItem>
  <TabItem label="PHP">
    ```php
    <?php
    use GuzzleHttp\Client;

    $aw = new Client(['base_uri' => 'https://api.astroway.info/v1/']);
    $r = $aw->post('human-design', [
        'headers' => ['X-Api-Key' => getenv('ASTROWAY_API_KEY')],
        'json' => [
            'date' => '1990-07-14',
            'time' => '14:30:00',
            'timezoneOffset' => 3,
            'latitude' => 50.4501,
            'longitude' => 30.5234,
        ],
    ]);
    $hd = json_decode($r->getBody(), true)['data'];
    echo "{$hd['type']} — {$hd['strategy']} — {$hd['authority']}\n";
    echo "Profile: {$hd['profile']}, Channels: " . count($hd['channels']) . "\n";
    ```
  </TabItem>
</Tabs>

## 경쟁사와 차별화된 기능

다른 API에서 제공하지 않는 엔드포인트:

- **Dream Rave** — 야간 디자인으로, 수면 중 무의식적 과정을 보여줌
- **Hologenetic Profile** — 유전자 키와 HD의 연결
- **Penta** — 팀(3~5명)을 위한 그룹 역학, 매우 희귀한 기술
- **시간 민감도** — 출생 시간을 ±5/15/30분 변경했을 때 맵이 어떻게 변하는지

## 사용 사례

- **HR-tech** — Penta와 그룹 호환성을 통한 팀 구성
- **코칭 플랫폼** — 타입과 전략 기반 개인화 추천
- **데이팅 앱** — HD 호환성을 추가 요소로 활용
- **콘텐츠 플랫폼** — 트랜짓을 통한 매일/매주 HD 인사이트 제공

## 요금

완전한 HD 맵 — **50크레딧**. Free 플랜에서는 매달 100개의 HD 맵을 무료로 제공합니다.

<CardGrid>
  <LinkCard title="자세한 예시 →" href="/examples/human-design/" description="파라미터, 응답, 필드" />
  <LinkCard title="빠른 시작" href="/getting-started/" description="5분 안에 첫 요청 보내기" />
  <LinkCard title="요금제" href="/pricing/" description="무료부터 Enterprise까지" />
</CardGrid>