API за човешки дизайн

Изградете върху същата валидирана, версирана услуга за изчисления, която захранва HumanDesign.ai чрез REST, нормализирани инструменти за HTTP на агенти и MCP. Всеки план запазва публикуваните си квоти и граници за достъп, базирани на нива, на всяка повърхност.

Започнете с API

Влезте и се абонирайте за API план, за да получите своя личен API ключ и да започнете да изграждате.

Впиши се

Изберете вашия план

Вашият API ключ работи в REST, Agent HTTP и MCP. Месечната квота се споделя между таксувани заявки на всяка платформа. Лимитите съответстват на humandesignapi.com/pricing.

Безплатно
$0/ мес
Крайни точки: Основни диаграми (v1), Връзка, Библиотека, Търсене на местоположение, HTTP и MCP ядро ​​на агент
  • 100 000 API извиквания/месец
  • Пълен набор от функции за създатели
  • Не е необходима кредитна карта
Започнете безплатно
създател
$25/ мес
Крайни точки: Всичко е безплатно + търговска употреба + табло за управление
  • 100 000 API извиквания/месец
  • Търговска употреба
  • API табло за управление и проследяване на употребата
Изберете план
Най - популярни
Startup
$50/ мес
Крайни точки: Всичко в Creator + пълни v3 графики, транзити, връщания, напредък
  • 100 000 API извиквания/месец
  • Пълни прогнози и възвръщаемост
  • Email подкрепа
Изберете план
Бизнес
$200/ мес
Крайни точки: Всичко в Startup + Celebrity, Batch, Calendars
  • 100 000 API извиквания/месец
  • Пакетна обработка
  • Поддръжка по имейл + телефон
Изберете план
Enterprise
Custom
Крайни точки: Пълен бизнес достъп през REST, Agent HTTP и MCP + персонализирани споразумения
  • Неограничена / персонализирана квота
  • Персонализирани крайни точки и договори
  • Специализирана поддръжка
Свържете се с продажбите

API документация

Справочник, съобразен с нивата, за REST крайни точки, HTTP инструменти на агенти и MCP достъп.

Общи
Всички планове
Стартъп+
Бизнес +

Въведение

API на 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, HTTP на агента и MCP и използват една единица само след валидиране на пълния им вход. Откриване, търсене на препратки, MCP initialize, ping, и tools/list консумират нула единици.

Достъп до крайна точка по план

категориясъздателStartupБизнесEnterprise
Всички планове
Основни диаграми (v1)✓✓✓✓
Диаграми на взаимоотношенията✓✓✓✓
Справочна библиотека✓✓✓✓
Търсене на местоположение✓✓✓✓
HTTP и MCP на агент (инструменти за създатели)✓✓✓✓
Стартъп+
Подобрени графики (v2, v3)-✓✓✓
Транзит и прогнозиране-✓✓✓
Графики на възвръщаемостта-✓✓✓
HTTP и MCP на агента (инструменти за стартиране)-✓✓✓
Бизнес +
Календар и планиране--✓✓
База данни за знаменитости--✓✓
Пакетна обработка--✓✓
HTTP и MCP на агент (бизнес инструменти)--✓✓

заверка

Всяка заявка трябва да включва вашия API ключ в заглавката, така че идентификационните данни да не могат да изтекат през URL адреси или регистрационни файлове на заявки. Свързаният с акаунта MCP използва OAuth.

Удостоверяване на заглавката (препоръчително)

X-Api-Key: your_api_key_here
Authorization: Bearer your_api_key_here

Не поставяйте API ключове във връзки, екранни снимки, анализи или регистрационни файлове на приложения.

Кодове за грешки: 401 (липсващ ключ), 403 (невалиден ключ или недостатъчно ниво), 429 (превишена месечна квота), 400 (неправилна заявка / невалидни параметри).

Основни диаграми

GET https://api.humandesign.ai/hd-data
Надстройте до Creator, за да отключите
Генериране на диаграма (v1)
Връща пълна диаграма на Human Design с тип, авторитет, стратегия, профил, дефиниция и всички активации на портите.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане (напр. 15.05.1990 г., 14:30:00)
timezoneнизДаЧасова зона по IANA (напр. Америка/Ню Йорк)
GET https://api.humandesign.ai/v2/hd-data
Надстройте до Startup, за да отключите
Подобрена диаграма (v2) Стартъп+
Подобрена натална карта с подробни свойства, разширени данни за центъра и канала.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона IANA
GET https://api.humandesign.ai/v3/hd-data
Надстройте до Startup, за да отключите
Пълна диаграма (v3) Стартъп+
Най-изчерпателната карта със зодиакални знаци, ретрограден статус, категории порти и пълна променлива терминология.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона IANA

Диаграми на взаимоотношенията

GET https://api.humandesign.ai/hd-data-composite
Надстройте до Creator, за да отключите
Композитна диаграма (v1)
Връща две отделни диаграми и обединена композитна диаграма, показваща динамиката на взаимоотношенията.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане на лице А
timezoneнизДаЧасова зона на човек А
date1ISO 8601ДаДата и час на раждане на лице Б
timezone1низДаЧасова зона на лице Б
GET https://api.humandesign.ai/v2/hd-data-composite
Надстройте до Creator, за да отключите
Подобрен композитен (v2)
Подобрен композитен резултат с химически резултати, подробен анализ и сравнение на гейтовете.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане на лице А
timezoneнизДаЧасова зона на човек А
date1ISO 8601ДаДата и час на раждане на лице Б
timezone1низДаЧасова зона на лице Б
ПУСНИ https://api.humandesign.ai/group-composite
Надстройте до Creator, за да отключите
Групов композитен
Генерирайте комбинирана диаграма за 3-12 души. Идеална за екипен анализ и групов коучинг.
ПараметърТипДлъженОписание
membersмасивДаМасив от обекти {date, timezone} (3-12 души)

Транзит и прогнозиране Стартъп+

Наслагвайте позициите на транзитните планети върху наталните карти, получавайте текущите позиции на планетите и генерирайте многодневни прогнози.

GET https://api.humandesign.ai/hd-data-transit
Надстройте до Startup, за да отключите
Графика на транзита
Вземете си транзитна карта, показваща вашата натална карта, насложена с позициите на транзитните планети.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона на раждане
TransitDateISO 8601ДаДата и час на транзита
TransitTimezoneнизДаЧасова зона на местоположението на транзита
GET https://api.humandesign.ai/planetary-positions
Надстройте до Startup, за да отключите
Планетарни позиции
Получете текущите позиции на планетите със състояния на достойнство, ретрограден статус и активиране на порти.
ПараметърТипДлъженОписание
dateISO 8601НеДата и час (по подразбиране е текущото UTC)
timezoneнизНеЧасова зона на IANA (по подразбиране е UTC)
GET https://api.humandesign.ai/planetary-forecast
Надстройте до Startup, за да отключите
Планетарна прогноза
Дневна прогноза, показваща преходите между гейтовете за определен период от време (максимум 31 дни).
ПараметърТипДлъженОписание
StartDateISO 8601ДаНачална дата на прогнозата
EndDateISO 8601ДаКрайна дата на прогнозата (максимум 31 дни)
timezoneнизНеЧасова зона на IANA (по подразбиране е UTC)

Графики на възвръщаемостта Стартъп+

Слънчево, Лунно, Сатурново и Хироново завръщане плюс вторични прогресии.

GET https://api.humandesign.ai/solar-return
Надстройте до Startup, за да отключите
Слънчево завръщане
Направете си диаграма за точния момент, в който Слънцето се връща в наталната ви позиция през дадена година.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона на раждане
Yearцяло числоДаГодина за слънчевото завръщане (напр. 2024)
GET https://api.humandesign.ai/lunar-return
Надстройте до Startup, за да отключите
Лунно завръщане
Таблица за това кога Луната се връща в наталната ви позиция през даден месец.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона на раждане
MonthнизДаМесец във формат ГГГГ-ММ (напр. 2024-06)
GET https://api.humandesign.ai/saturn-return
Надстройте до Startup, за да отключите
Завръщане на Сатурн
Информация и графики за завръщането на Сатурн (~29, ~58 години).
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона на раждане
GET https://api.humandesign.ai/chiron-return
Надстройте до Startup, за да отключите
Завръщането на Хирон
Информация и диаграма за завръщането на Хирон (~50 години).
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона на раждане
GET https://api.humandesign.ai/progressed-chart
Надстройте до Startup, за да отключите
Диаграма на напредъка
Вторична прогресивна диаграма, показваща еволюцията във времето.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона на раждане
ProgressedToISO 8601ДаЦелева дата на прогресия

Календар и планиране Бизнес +

Календари на портите, сигнали за транзит, фази на луната и експорт в iCal.

GET https://api.humandesign.ai/gate-calendar
Надстройте до Бизнес, за да отключите
Календар на портата
Месечен календар, показващ дневните позиции на планетите и активирането на портите.
ПараметърТипДлъженОписание
Yearцяло числоДаКалендарна година (напр. 2024)
Monthцяло числоДаКалендарен месец (1-12)
timezoneнизНеЧасова зона на IANA (по подразбиране е UTC)
GET https://api.humandesign.ai/transit-alerts
Надстройте до Бизнес, за да отключите
Сигнали за обществен транспорт
Персонализирани транзитни сигнали за натална карта (до 90 дни).
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона на раждане
Daysцяло числоНеДни за прогнозиране (по подразбиране: 30, макс.: 90)
GET https://api.humandesign.ai/moon-phases
Надстройте до Бизнес, за да отключите
Фази на луната
Месечни лунни фази и дневни позиции на лунните порти.
ПараметърТипДлъженОписание
Yearцяло числоДаКалендарна година
Monthцяло числоДаКалендарен месец (1-12)
timezoneнизНеЧасова зона на IANA (по подразбиране е UTC)
GET https://api.humandesign.ai/ical-export
Надстройте до Бизнес, за да отключите
Експортиране в iCal
Експортирайте прогнозата за транзита като .ics календарен файл за изтегляне.
ПараметърТипДлъженОписание
dateISO 8601ДаДата и час на раждане
timezoneнизДаЧасова зона на раждане
Daysцяло числоНеДни за включване (по подразбиране: 30, макс.: 90)

Справочна библиотека

Достъп до пълната HD референтна база данни — всички 64 гейта, 36 канала, 9 центъра и 12 профила.

GET /библиотека/порти
Надстройте до Creator, за да отключите
Списък на всички порти
Получете всичките 64 порти с обобщена информация. Не са необходими допълнителни параметри.
GET /библиотека/порти/{номерНапорта}
Надстройте до Creator, за да отключите
Получете подробности за портата
Подробна информация за портите (1-64), включително линии, теми и описания.
ПараметърТипДлъженОписание
gateNumberцяло число (път)ДаНомер на порта (1-64)
GET /библиотека/канали
Надстройте до Creator, за да отключите
Списък на всички канали
Вземете всичките 36 канала с обобщена информация.
GET /библиотека/канали/{channelId}
Надстройте до Creator, за да отключите
Получете подробности за канала
Подробна информация за канала (напр. "1-8").
ПараметърТипДлъженОписание
channelIdниз (път)ДаИдентификатор на канала (напр. „1-8“)
GET /библиотека/центрове
Надстройте до Creator, за да отключите
Списък на всички центрове
Вземете всичките 9 центъра с обобщена информация.
GET /библиотека/центрове/{имеНаЦентър}
Надстройте до Creator, за да отключите
Получете подробности за центъра
Подробна информация за центъра (напр. "Сакрален", "G", "Слънчев сплит").
ПараметърТипДлъженОписание
centerNameниз (път)ДаИме на центъра (напр. „Сакрален“)
GET /библиотека/профили
Надстройте до Creator, за да отключите
Списък на всички профили
Вземете всичките 12 профила с обобщена информация.
GET /библиотека/профили/{идентификатор_на_профил}
Надстройте до Creator, за да отключите
Получете подробности за профила
Подробна информация за профила (напр. „1/3“, „4-6“).
ПараметърТипДлъженОписание
profileIdниз (път)ДаИдентификационен номер на профила (напр. „1/3“ или „4-6“)

Търсене на местоположение

GET https://api.humandesign.ai/locations
Надстройте до Creator, за да отключите
Търсене на местоположения и часови зони
Търсене на градове по име. Връща съответстващи местоположения с данни за часовата зона на IANA за точни изчисления на графиките. Поддържа частични заявки в стил автоматично довършване.
ПараметърТипДлъженОписание
queryнизДаГрад или регион за търсене (напр. „Лондон“)

Пакетна обработка Бизнес +

ПУСНИ https://api.humandesign.ai/batch/charts
Надстройте до Бизнес, за да отключите
Генериране на пакетни диаграми
Генерирайте до 50 диаграми с една заявка за ефективна групова обработка.
ПараметърТипДлъженОписание
chartsмасивДаМасив от обекти {id?, date, timezone} (максимум 50)

База данни за знаменитости Бизнес +

Търсене и извличане на данни от класациите на Human Design за известни личности.

GET https://api.humandesign.ai/celebrity/search
Надстройте до Бизнес, за да отключите
Търсене на знаменитости
Търсене по име. Връща съответстващи резултати с основни данни от диаграмата.
ПараметърТипДлъженОписание
queryнизДаТърсена заявка (име)
limitцяло числоНеМаксимален брой резултати (по подразбиране: 20, макс.: 100)
GET https://api.humandesign.ai/celebrity/{slugOrId}
Надстройте до Бизнес, за да отключите
Получете подробности за знаменитости
Пълни данни за знаменитостите по идентификационен номер (напр. „elon-musk“) или UUID.
ПараметърТипДлъженОписание
slugOrIdниз (път)ДаЗнаменитост или UUID

Нуждаете се от помощ? Свържете се с нашия екип за API на [email protected]