# API Thiết kế con người

AstroWay API có **12 endpoints Human Design** — độ phủ sóng HD sâu nhất trong số các API thương mại. Từ bodygraph cơ bản đến động lực nhóm Penta và Dream Rave.

## Những gì được tính toán

Bản đồ HD đầy đủ bao gồm:

- **Loại** — Manifestor, Generator, Manifesting Generator, Projector, Reflector
- **Chiến lược** — cơ chế ra quyết định
- **Thẩm quyền** — thẩm quyền nội tại (Sacral, Emotional, Splenic, Ego, Self-Projected, Mental, Lunar)
- **Cung** — sự kết hợp của các đường (1/3, 2/4, 3/5, 4/6, v.v.)
- **Định nghĩa** — single, split, triple-split, quadruple-split
- **Thập tự nhập thế** — tên, quý, 4 cổng
- **Trung tâm** — 9 trung tâm với cờ defined/open
- **Kênh** — các kênh được định nghĩa với tên
- **Kích hoạt** — 26 lần kích hoạt (13 Personality + 13 Design)

## 12 endpoints

| Endpoint | Credit | Trả về |
|---|---|---|
| `/v1/human-design` | 50 | Bản đồ HD đầy đủ |
| `/v1/human-design/transits` | 50 | Quá cảnh HD vào ngày đã chọn |
| `/v1/human-design/compatibility` | 100 | Tương thích giữa hai bản đồ HD |
| `/v1/hd/incarnation-cross` | 50 | Thập tự nhập thế |
| `/v1/hd/dream-rave` | 50 | Bản đồ Dream Rave (thiết kế đêm) |
| `/v1/hd/hologenetic` | 50 | Hologenetic Profile |
| `/v1/hd/sensitivity` | 50 | Độ nhạy thời gian (ảnh hưởng của việc thay đổi thời gian sinh) |
| `/v1/hd/circuitry` | 20 | Phân tích mạch (Individual, Tribal, Collective) |
| `/v1/hd/penta` | 100 | Penta — động lực nhóm 3–5 người |
| `/v1/hd/group-overlay` | 100 | Lớp phủ nhóm |
| `/v1/hd/design-date` | 10 | Ngày Design (88° Mặt Trời trước khi sinh) |
| `/v1/hd/rave-new-years` | 10 | Ngày Rave New Year |

## Ví dụ

<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>

## Tính năng độc quyền

Các endpoints không có ở đối thủ cạnh tranh:

- **Dream Rave** — thiết kế đêm, thể hiện các quá trình vô thức khi ngủ
- **Hologenetic Profile** — mối liên hệ giữa các gen key và Human Design
- **Penta** — động lực nhóm cho nhóm (3–5 người), kỹ thuật cực kỳ hiếm
- **Độ nhạy thời gian** — mức độ ảnh hưởng khi thay đổi thời gian sinh ±5/15/30 phút

## Ai sử dụng

- **HR-tech** — tuyển dụng nhóm thông qua Penta và tương thích nhóm
- **Nền tảng coaching** — đề xuất cá nhân hóa dựa trên loại và chiến lược
- **Ứng dụng hẹn hò** — tương thích HD như yếu tố bổ sung
- **Nền tảng nội dung** — insights HD hàng ngày/tuần thông qua quá cảnh

## Chi phí

Bản đồ HD đầy đủ — **50 credit**. Ở gói Free, bạn nhận được 100 bản đồ HD miễn phí mỗi tháng.

<CardGrid>
  <LinkCard title="Ví dụ chi tiết →" href="/examples/human-design/" description="Tham số, phản hồi, trường" />
  <LinkCard title="Bắt đầu nhanh" href="/getting-started/" description="Yêu cầu đầu tiên trong 5 phút" />
  <LinkCard title="Bảng giá" href="/pricing/" description="Từ miễn phí đến doanh nghiệp" />
</CardGrid>