API طراحی انسانی

بر اساس همان سرویس محاسبه‌ی معتبر و نسخه‌بندی‌شده‌ای که HumanDesign.ai را از طریق REST، ابزارهای HTTP نرمال‌شده‌ی Agent و MCP پشتیبانی می‌کند، بسازید. هر طرح، سهمیه‌ی منتشرشده و مرز دسترسی مبتنی بر لایه‌ی خود را در هر سطحی حفظ می‌کند.

شروع کار با API

برای دریافت کلید API خصوصی خود و شروع به ساخت، وارد سیستم شوید و در یک طرح API مشترک شوید.

ورود

انتخاب طرح شما

کلید API شما در REST، Agent HTTP و MCP کار می‌کند. سهمیه ماهانه بین درخواست‌های صورتحساب‌شده در هر سطحی مشترک است. محدودیت‌ها با humandesignapi.com/pricing مطابقت دارند.

رایگان
$0/ ماه
نقاط پایانی: نمودارهای اصلی (نسخه ۱)، روابط، کتابخانه، جستجوی مکان، عامل هسته HTTP و MCP
  • ۱۰۰۰۰۰ فراخوانی API در ماه
  • مجموعه کامل ویژگی‌های Creator
  • کارت اعتباری لازم نیست
رایگان شروع کنید
ایجاد کننده
$25/ ماه
نقاط پایانی: همه چیز رایگان + استفاده تجاری + داشبورد
  • ۱۰۰۰۰۰ فراخوانی API در ماه
  • استفاده تجاری
  • داشبورد API و ردیابی میزان استفاده
انتخاب طرح
محبوبترین
راه اندازی
$50/ ماه
نقاط پایانی: همه چیز در Creator + نمودارهای کامل نسخه ۳، انتقال‌ها، بازگشت‌ها، پیشرفت‌ها
  • ۱۰۰۰۰۰ فراخوانی API در ماه
  • پیش‌بینی‌ها و بازده‌های کامل
  • پشتیبانی ایمیل
انتخاب طرح
کسب و کار
$200/ ماه
نقاط پایانی: همه چیز در استارتاپ + افراد مشهور، دسته‌ها، تقویم‌ها
  • ۱۰۰۰۰۰ فراخوانی API در ماه
  • پردازش دسته ای
  • پشتیبانی ایمیل + تلفن
انتخاب طرح
سرمایه گذاری
سفارشی
نقاط پایانی: دسترسی کامل تجاری به REST، Agent HTTP و MCP + توافق‌نامه‌های سفارشی
  • سهمیه نامحدود / سفارشی
  • نقاط پایانی و قراردادهای سفارشی
  • پشتیبانی اختصاصی
با فروش تماس بگیرید

مستندات API

مرجعی آگاه از لایه‌ها برای نقاط پایانی REST، ابزارهای HTTP عامل و دسترسی MCP.

سوالات عمومی
همه طرح‌ها
استارتاپ+
تجارت +

معرفی

رابط برنامه‌نویسی کاربردی HumanDesign.ai همان سرویس محاسبه‌ی اعتبارسنجی‌شده و نسخه‌بندی‌شده‌ای را ارائه می‌دهد که HumanDesign.ai را قدرتمند می‌کند. برای ادغام‌های مستقیم از REST، برای کلاینت‌های اکشن از Agent HTTP یا اتصال یک کلاینت MCP به نقطه‌ی پایانی ریشه‌ی متعارف استفاده کنید.

URL های پایه

https://api.humandesign.ai
https://api.humandesign.ai/agent/v1/tools/*
https://mcp.humandesign.ai/

درخواست‌های محاسباتی مصرفی، یک سهمیه را بین REST، Agent HTTP و MCP به اشتراک می‌گذارند و تنها پس از اعتبارسنجی کامل ورودی خود، از یک واحد استفاده می‌کنند. کشف، جستجوی مرجع، MCP initialize, pingو tools/list صفر واحد مصرف کند.

دسترسی به نقاط پایانی بر اساس طرح

دسته بندیایجاد کنندهراه اندازیکسب و کارسرمایه گذاری
همه طرح‌ها
نمودارهای اصلی (نسخه ۱)✓✓✓✓
نمودارهای روابط✓✓✓✓
کتابخانه مرجع✓✓✓✓
جستجوی مکان✓✓✓✓
عامل HTTP و MCP (ابزارهای سازنده)✓✓✓✓
استارتاپ+
نمودارهای پیشرفته (نسخه ۲، نسخه ۳)-✓✓✓
حمل و نقل و پیش‌بینی-✓✓✓
نمودارهای بازگشت-✓✓✓
HTTP و MCP عامل (ابزارهای راه‌اندازی)-✓✓✓
تجارت +
تقویم و برنامه‌ریزی--✓✓
پایگاه داده افراد مشهور--✓✓
پردازش دسته ای--✓✓
HTTP و MCP عامل (ابزارهای تجاری)--✓✓

تصدیق

هر درخواست باید شامل کلید API شما در هدر باشد تا اعتبارنامه‌ها از طریق URLها یا گزارش‌های پرس‌وجو نشت نکنند. MCP متصل به حساب از OAuth استفاده می‌کند.

احراز هویت هدر (توصیه شده)

X-Api-Key: your_api_key_here
Authorization: Bearer your_api_key_here

کلیدهای API را در لینک‌ها، اسکرین‌شات‌ها، آنالیتیکس‌ها یا لاگ‌های برنامه قرار ندهید.

کدهای خطا: ۴۰۱ (کلید گم شده)، ۴۰۳ (کلید نامعتبر یا سطح ناکافی)، ۴۲۹ ​​(سهمیه ماهانه تکمیل شده)، ۴۰۰ (درخواست نادرست / پارامترهای نامعتبر).

نمودارهای اصلی

شو https://api.humandesign.ai/hd-data
برای باز کردن قفل، به Creator ارتقا دهید
ایجاد نمودار (نسخه ۱)
یک نمودار کامل طراحی انسانی را با نوع، اختیار، استراتژی، نمایه، تعریف و تمام فعال‌سازی‌های دروازه برمی‌گرداند.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد (مثلاً ‎1990-05-15T14:30:00)
timezoneرشتهبلهمنطقه زمانی IANA (مثلاً America/New_York)
شو https://api.humandesign.ai/v2/hd-data
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
نمودار پیشرفته (نسخه ۲) استارتاپ+
نمودار تولد بهبود یافته با ویژگی‌های دقیق، داده‌های مرکز و کانال گسترش یافته.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی IANA
شو https://api.humandesign.ai/v3/hd-data
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
نمودار کامل (نسخه ۳) استارتاپ+
جامع‌ترین نمودار با علائم زودیاک، وضعیت رتروگراد، دسته بندی دروازه‌ها و اصطلاحات کامل متغیر.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی IANA

نمودارهای روابط

شو https://api.humandesign.ai/hd-data-composite
برای باز کردن قفل، به Creator ارتقا دهید
نمودار ترکیبی (نسخه ۱)
دو نمودار مجزا و یک نمودار ترکیبی ادغام‌شده را برمی‌گرداند که پویایی روابط را نشان می‌دهد.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد شخص الف
timezoneرشتهبلهمنطقه زمانی شخص A
date1ISO 8601بلهتاریخ و زمان تولد شخص B
timezone1رشتهبلهمنطقه زمانی شخص B
شو https://api.humandesign.ai/v2/hd-data-composite
برای باز کردن قفل، به Creator ارتقا دهید
کامپوزیت پیشرفته (نسخه ۲)
کامپوزیت پیشرفته با نمرات شیمی، تجزیه و تحلیل دقیق و مقایسه گیت.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد شخص الف
timezoneرشتهبلهمنطقه زمانی شخص A
date1ISO 8601بلهتاریخ و زمان تولد شخص B
timezone1رشتهبلهمنطقه زمانی شخص B
پست https://api.humandesign.ai/group-composite
برای باز کردن قفل، به Creator ارتقا دهید
گروه کامپوزیت
یک نمودار ترکیبی برای ۳ تا ۱۲ نفر ایجاد کنید. ایده‌آل برای تحلیل تیمی و کوچینگ گروهی.
پارامترنوعضروریتوضیحات:
membersصفبلهآرایه‌ای از اشیاء {date, timezone} (۳-۱۲ نفر)

حمل و نقل و پیش‌بینی استارتاپ+

موقعیت‌های گذر را روی نمودارهای تولد همپوشانی کنید، موقعیت‌های فعلی سیارات را دریافت کنید و پیش‌بینی‌های چند روزه ایجاد کنید.

شو https://api.humandesign.ai/hd-data-transit
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
نمودار حمل و نقل عمومی
یک نمودار ترانزیت تهیه کنید که نمودار تولد شما را با موقعیت‌های سیارات در حال گذار نشان دهد.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی تولد
TransitDateISO 8601بلهتاریخ و زمان ترانزیت
TransitTimezoneرشتهبلهمنطقه زمانی مکان حمل و نقل
شو https://api.humandesign.ai/planetary-positions
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
موقعیت های سیاره ای
موقعیت‌های فعلی سیارات را با حالت‌های عزت، وضعیت قهقرایی و فعال‌سازی دروازه‌ها دریافت کنید.
پارامترنوعضروریتوضیحات:
dateISO 8601نهتاریخ و زمان (پیش‌فرض بر اساس UTC فعلی)
timezoneرشتهنهمنطقه زمانی IANA (پیش‌فرض UTC)
شو https://api.humandesign.ai/planetary-forecast
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
پیش‌بینی سیاره‌ای
پیش‌بینی روزانه که انتقال دروازه را در یک محدوده زمانی (حداکثر ۳۱ روز) نشان می‌دهد.
پارامترنوعضروریتوضیحات:
StartDateISO 8601بلهتاریخ شروع پیش‌بینی
EndDateISO 8601بلهتاریخ پایان پیش‌بینی (حداکثر ۳۱ روز)
timezoneرشتهنهمنطقه زمانی IANA (پیش‌فرض UTC)

نمودارهای بازگشت استارتاپ+

بازگشت‌های خورشیدی، قمری، زحلی و کایرون به علاوه‌ی پیشرفت‌های ثانویه.

شو https://api.humandesign.ai/solar-return
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
بازگشت خورشیدی
لحظه دقیق بازگشت خورشید به موقعیت تولد شما در یک سال معین را روی نمودار مشخص کنید.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی تولد
Yearعدد صحیحبلهسال بازگشت خورشیدی (مثلاً ۲۰۲۴)
شو https://api.humandesign.ai/lunar-return
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
بازگشت قمری
نموداری رسم کنید که نشان دهد ماه در یک ماه معین چه زمانی به موقعیت ماه تولد شما بازمی‌گردد.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی تولد
Monthرشتهبلهماه با فرمت YYYY-MM (مثلاً 2024-06)
شو https://api.humandesign.ai/saturn-return
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
بازگشت کیوان
اطلاعات و نمودارهای بازگشت زحل (حدود ۲۹ سال، حدود ۵۸ سال).
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی تولد
شو https://api.humandesign.ai/chiron-return
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
بازگشت شیرون
اطلاعات و نمودار بازگشت Chiron (حدود ۵۰ سال).
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی تولد
شو https://api.humandesign.ai/progressed-chart
برای باز کردن قفل، به حالت راه‌اندازی ارتقا دهید
نمودار پیشرفت
نمودار پیشرفت ثانویه که تکامل را در طول زمان نشان می‌دهد.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی تولد
ProgressedToISO 8601بلهتاریخ پیشرفت هدف

تقویم و برنامه‌ریزی تجارت +

تقویم‌های دروازه، هشدارهای حمل و نقل عمومی، فازهای ماه و خروجی iCal.

شو https://api.humandesign.ai/gate-calendar
برای باز کردن قفل، به حالت تجاری ارتقا دهید
تقویم دروازه
تقویم ماهانه که موقعیت‌های روزانه سیارات و فعال‌سازی دروازه‌ها را نشان می‌دهد.
پارامترنوعضروریتوضیحات:
Yearعدد صحیحبلهسال تقویمی (مثلاً ۲۰۲۴)
Monthعدد صحیحبلهماه تقویمی (۱-۱۲)
timezoneرشتهنهمنطقه زمانی IANA (پیش‌فرض UTC)
شو https://api.humandesign.ai/transit-alerts
برای باز کردن قفل، به حالت تجاری ارتقا دهید
هشدارهای حمل و نقل عمومی
هشدارهای حمل و نقل شخصی‌سازی‌شده برای نمودار تولد (تا ۹۰ روز).
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی تولد
Daysعدد صحیحنهروزهای آینده (پیش‌فرض: ۳۰، حداکثر: ۹۰)
شو https://api.humandesign.ai/moon-phases
برای باز کردن قفل، به حالت تجاری ارتقا دهید
مراحل ماه
مراحل ماهانه ماه و موقعیت‌های دروازه ماه روزانه.
پارامترنوعضروریتوضیحات:
Yearعدد صحیحبلهسال تقویمی
Monthعدد صحیحبلهماه تقویمی (۱-۱۲)
timezoneرشتهنهمنطقه زمانی IANA (پیش‌فرض UTC)
شو https://api.humandesign.ai/ical-export
برای باز کردن قفل، به حالت تجاری ارتقا دهید
صادرات iCal
پیش‌بینی ترانزیت را به صورت فایل تقویم .ics قابل دانلود صادر کنید.
پارامترنوعضروریتوضیحات:
dateISO 8601بلهتاریخ و زمان تولد
timezoneرشتهبلهمنطقه زمانی تولد
Daysعدد صحیحنهتعداد روزهای قابل احتساب (پیش‌فرض: ۳۰، حداکثر: ۹۰)

کتابخانه مرجع

به پایگاه داده مرجع کامل HD دسترسی داشته باشید - تمام ۶۴ دروازه، ۳۶ کانال، ۹ مرکز و ۱۲ پروفایل.

شو /کتابخانه/دروازه‌ها
برای باز کردن قفل، به Creator ارتقا دهید
فهرست همه دروازه‌ها
تمام ۶۴ دروازه را به همراه خلاصه اطلاعات دریافت کنید. هیچ پارامتر اضافی لازم نیست.
شو /library/gates/{gateNumber}
برای باز کردن قفل، به Creator ارتقا دهید
جزئیات دروازه را دریافت کنید
اطلاعات دقیق دروازه (۱-۶۴) شامل خطوط، تم‌ها و توضیحات.
پارامترنوعضروریتوضیحات:
gateNumberعدد صحیح (مسیر)بلهشماره دروازه (1-64)
شو /کتابخانه/کانال‌ها
برای باز کردن قفل، به Creator ارتقا دهید
فهرست کردن همه کانال‌ها
تمام ۳۶ کانال را به همراه خلاصه اطلاعات دریافت کنید.
شو /library/channels/{channelId}
برای باز کردن قفل، به Creator ارتقا دهید
جزئیات کانال را دریافت کنید
اطلاعات دقیق کانال (مثلاً «۱-۸»).
پارامترنوعضروریتوضیحات:
channelIdرشته (مسیر)بلهشناسه کانال (مثلاً "1-8")
شو /کتابخانه/مراکز
برای باز کردن قفل، به Creator ارتقا دهید
فهرست همه مراکز
هر 9 مرکز را به همراه خلاصه اطلاعات دریافت کنید.
شو /library/centers/{centerName}
برای باز کردن قفل، به Creator ارتقا دهید
دریافت جزئیات مرکز
اطلاعات دقیق مرکز (مثلاً "خاجی"، "G"، "شبکه خورشیدی").
پارامترنوعضروریتوضیحات:
centerNameرشته (مسیر)بلهنام مرکز (مثلاً "خاجی")
شو /کتابخانه/پروفایل‌ها
برای باز کردن قفل، به Creator ارتقا دهید
لیست همه پروفایل‌ها
هر ۱۲ پروفایل را به همراه خلاصه اطلاعات دریافت کنید.
شو /library/profiles/{profileId}
برای باز کردن قفل، به Creator ارتقا دهید
دریافت جزئیات پروفایل
اطلاعات دقیق پروفایل (مثلاً "۱/۳"، "۴-۶").
پارامترنوعضروریتوضیحات:
profileIdرشته (مسیر)بلهشناسه پروفایل (مثلاً "1/3" یا "4-6")

جستجوی مکان

شو https://api.humandesign.ai/locations
برای باز کردن قفل، به Creator ارتقا دهید
جستجوی مکان‌ها و مناطق زمانی
جستجوی شهرها بر اساس نام. مکان‌های منطبق با داده‌های منطقه زمانی IANA را برای محاسبات دقیق نمودار برمی‌گرداند. از پرس‌وجوهای جزئی به سبک تکمیل خودکار پشتیبانی می‌کند.
پارامترنوعضروریتوضیحات:
queryرشتهبلهشهر یا منطقه مورد جستجو (مثلاً "لندن")

پردازش دسته ای تجارت +

پست https://api.humandesign.ai/batch/charts
برای باز کردن قفل، به حالت تجاری ارتقا دهید
تولید نمودار دسته‌ای
برای پردازش انبوه کارآمد، حداکثر 50 نمودار را در یک درخواست واحد تولید کنید.
پارامترنوعضروریتوضیحات:
chartsصفبلهآرایه‌ای از اشیاء {id?, date, timezone} (حداکثر ۵۰ عدد)

پایگاه داده افراد مشهور تجارت +

جستجو و بازیابی داده‌های نمودار طراحی انسانی برای افراد مشهور.

شو https://api.humandesign.ai/celebrity/search
برای باز کردن قفل، به حالت تجاری ارتقا دهید
جستجوی افراد مشهور
جستجو بر اساس نام. نتایج منطبق با داده‌های نمودار پایه را برمی‌گرداند.
پارامترنوعضروریتوضیحات:
queryرشتهبلهعبارت جستجو (نام)
limitعدد صحیحنهحداکثر نتایج (پیش‌فرض: ۲۰، حداکثر: ۱۰۰)
شو https://api.humandesign.ai/celebrity/{slugOrId}
برای باز کردن قفل، به حالت تجاری ارتقا دهید
جزئیات سلبریتی‌ها را دریافت کنید
جزئیات کامل سلبریتی‌ها بر اساس slug (مثلاً "elon-musk") یا UUID.
پارامترنوعضروریتوضیحات:
slugOrIdرشته (مسیر)بلهنام مستعار سلبریتی یا UUID

به کمک نیاز دارید؟ با تیم API ما از طریق [email protected] تماس بگیرید.