Human Design API

Izgradite na istoj validiranoj, verziranoj usluzi izračuna koja pokreće HumanDesign.ai putem REST-a, normaliziranih HTTP alata agenata i MCP-a. Svaki plan zadržava svoj objavljeni limit i granicu pristupa zasnovanu na nivoima na svakoj površini.

Započnite s API-jem

Prijavite se i pretplatite se na API plan kako biste dobili svoj privatni API ključ i počeli s izradom.

Prijavi se

Odaberite svoj plan

Vaš API ključ funkcioniše na REST, Agent HTTP i MCP mrežama. Mjesečna kvota se dijeli na naplaćene zahtjeve na svakoj platformi. Ograničenja se podudaraju sa humandesignapi.com/pricing.

Besplatno
$0/ mjesec
Krajnje tačke: Osnovni grafikoni (v1), odnosi, biblioteka, pretraga lokacije, HTTP i MCP jezgro agenta
  • 100 API poziva mjesečno
  • Kompletan set funkcija za kreatore
  • Nije potrebna kreditna kartica
Počni besplatno
tvorac
$25/ mjesec
Krajnje tačke: Sve besplatno + komercijalna upotreba + kontrolna ploča
  • 10,000 API poziva mjesečno
  • Komercijalna upotreba
  • API kontrolna ploča i praćenje korištenja
Izaberite Plan
Najpopularniji
Startup
$50/ mjesec
Krajnje tačke: Sve u Creatoru + potpuni v3 grafikoni, tranziti, povratci, napredak
  • 100,000 API poziva mjesečno
  • Potpune prognoze i povrati
  • E-mail podrška
Izaberite Plan
Business
$200/ mjesec
Krajnje tačke: Sve u kategoriji Startup + Celebrity, Batch, Kalendari
  • 1,000,000 API poziva mjesečno
  • Paketna obrada
  • Podrška putem e-pošte i telefona
Izaberite Plan
preduzeće
običaj
Krajnje tačke: Potpuni poslovni pristup putem REST-a, Agent HTTP-a i MCP-a + prilagođeni ugovori
  • Neograničena / prilagođena kvota
  • Prilagođene krajnje tačke i ugovori
  • Namenska podrška
Obratite se prodaji

API dokumentacija

Referenca svjesna nivoa za REST krajnje tačke, HTTP alate agenata i MCP pristup.

Opšti
Svi planovi
Startup+
Business +

Uvod

HumanDesign.ai API pruža istu validiranu, verziranu uslugu izračuna koja pokreće HumanDesign.ai. Koristite REST za direktne integracije, Agent HTTP za klijente akcija ili povežite MCP klijenta sa kanonskom korijenskom krajnjom tačkom.

Osnovni URL-ovi

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

Zahtjevi za izračunavanje dijele jednu kvotu između REST-a, HTTP agenta i MCP-a i koriste jednu jedinicu tek nakon što je njihov potpuni unos validiran. Otkrivanje, pretraga referenci, MCP initialize, ping, I tools/list potrošiti nula jedinica.

Pristup krajnjim tačkama po planu

kategorijatvoracStartupBusinesspreduzeće
Svi planovi
Osnovni grafikoni (v1)✓✓✓✓
Grafikoni odnosa✓✓✓✓
Referentna biblioteka✓✓✓✓
Pretraživanje lokacije✓✓✓✓
Agent HTTP i MCP (alati za kreatore)✓✓✓✓
Startup+
Poboljšani grafikoni (v2, v3)-✓✓✓
Tranzit i prognoza-✓✓✓
Grafikoni povrata-✓✓✓
Agent HTTP i MCP (alati za pokretanje)-✓✓✓
Business +
Kalendar & Zakazivanje--✓✓
Baza podataka slavnih osoba--✓✓
Batch Processing--✓✓
Agent HTTP i MCP (Poslovni alati)--✓✓

Authentication

Svaki zahtjev mora sadržavati vaš API ključ u zaglavlju kako se vjerodajnice ne bi mogle otkriti putem URL-ova ili zapisnika upita. MCP povezan s računom koristi OAuth.

Autentifikacija zaglavlja (preporučeno)

X-Api-Key: your_api_key_here
Authorization: Bearer your_api_key_here

Ne postavljajte API ključeve u linkove, snimke ekrana, analitiku ili zapisnike aplikacije.

Kodovi grešaka: 401 (nedostaje ključ), 403 (nevažeći ključ ili nedovoljan nivo), 429 (premašena mjesečna kvota), 400 (loš zahtjev / nevažeći parametri).

Osnovni grafikoni

GET https://api.humandesign.ai/hd-data
Nadogradite na Kreatora da biste otključali
Generiraj grafikon (v1)
Vraća kompletan grafikon Human Designa sa tipom, autoritetom, strategijom, profilom, definicijom i svim aktivacijama vrata.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja (npr. 1990-05-15T14:30:00)
timezonenizDaIANA vremenska zona (npr. Amerika/New_York)
GET https://api.humandesign.ai/v2/hd-data
Nadogradite na Startup da biste otključali
Poboljšani grafikon (v2) Startup+
Poboljšana natalna karta s detaljnim svojstvima, proširenim podacima o centru i kanalu.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaIANA vremenska zona
GET https://api.humandesign.ai/v3/hd-data
Nadogradite na Startup da biste otključali
Cijeli grafikon (v3) Startup+
Najopsežnija karta sa horoskopskim znacima, retrogradnim statusom, kategorijama kapija i kompletnom varijabilnom terminologijom.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaIANA vremenska zona

Grafikoni odnosa

GET https://api.humandesign.ai/hd-data-composite
Nadogradite na Kreatora da biste otključali
Kompozitni grafikon (v1)
Vraća dva pojedinačna grafikona i spojeni kompozitni grafikon koji prikazuje dinamiku odnosa.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja osobe A
timezonenizDaVremenska zona osobe A
date1ISO 8601DaDatum i vrijeme rođenja osobe B
timezone1nizDaVremenska zona osobe B
GET https://api.humandesign.ai/v2/hd-data-composite
Nadogradite na Kreatora da biste otključali
Poboljšani kompozitni (v2)
Poboljšani kompozitni rezultat s hemijskim rezultatima, detaljnom analizom i poređenjem gejtova.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja osobe A
timezonenizDaVremenska zona osobe A
date1ISO 8601DaDatum i vrijeme rođenja osobe B
timezone1nizDaVremenska zona osobe B
POST https://api.humandesign.ai/group-composite
Nadogradite na Kreatora da biste otključali
Grupni kompozit
Generirajte kompozitni grafikon za 3-12 osoba. Idealno za analizu tima i grupni koučing.
parametartippotrebanOpis
membersarrayDaNiz objekata tipa {date, timezone} (3-12 osoba)

Tranzit i prognoza Startup+

Prekrijte tranzitne pozicije na natalnim kartama, dobijte trenutne planetarne pozicije i generirajte višednevne prognoze.

GET https://api.humandesign.ai/hd-data-transit
Nadogradite na Startup da biste otključali
Transit Chart
Nabavite tranzitnu kartu koja prikazuje vašu natalnu kartu preklopljenu s tranzitnim planetarnim položajima.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaVremenska zona rođenja
TransitDateISO 8601DaDatum i vrijeme tranzita
TransitTimezonenizDaVremenska zona lokacije javnog prijevoza
GET https://api.humandesign.ai/planetary-positions
Nadogradite na Startup da biste otključali
Planetarne pozicije
Dobijte trenutne planetarne položaje sa stanjima dostojanstva, retrogradnim statusom i aktivacijama vrata.
parametartippotrebanOpis
dateISO 8601NeDatum i vrijeme (zadano je trenutno UTC)
timezonenizNeIANA vremenska zona (zadano je UTC)
GET https://api.humandesign.ai/planetary-forecast
Nadogradite na Startup da biste otključali
Planetarna prognoza
Dnevna prognoza koja prikazuje promjene između izlaza za određeni vremenski raspon (maksimalno 31 dan).
parametartippotrebanOpis
StartDateISO 8601DaDatum početka prognoze
EndDateISO 8601DaDatum završetka prognoze (maksimalno 31 dan)
timezonenizNeIANA vremenska zona (zadano je UTC)

Grafikoni povrata Startup+

Solarni, Lunarni, Saturnov i Hironov povratak plus sekundarne progresije.

GET https://api.humandesign.ai/solar-return
Nadogradite na Startup da biste otključali
Solarni povratak
Napravite grafikon za tačan trenutak kada se Sunce vraća u vaš natalni položaj u datoj godini.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaVremenska zona rođenja
YearintegerDaGodina solarnog povratka (npr. 2024)
GET https://api.humandesign.ai/lunar-return
Nadogradite na Startup da biste otključali
Mjesečev povratak
Grafikon koji pokazuje kada se Mjesec vraća u vaš natalni položaj u datom mjesecu.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaVremenska zona rođenja
MonthnizDaMjesec u formatu GGGG-MM (npr. 2024-06)
GET https://api.humandesign.ai/saturn-return
Nadogradite na Startup da biste otključali
Povratak Saturna
Informacije i grafikoni o povratku Saturna (~29, ~58 godina).
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaVremenska zona rođenja
GET https://api.humandesign.ai/chiron-return
Nadogradite na Startup da biste otključali
Povratak Hirona
Informacije i grafikon o povratku Hirona (~50 godina).
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaVremenska zona rođenja
GET https://api.humandesign.ai/progressed-chart
Nadogradite na Startup da biste otključali
Napredni grafikon
Sekundarni progresivni grafikon koji prikazuje evoluciju tokom vremena.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaVremenska zona rođenja
ProgressedToISO 8601DaCiljani datum napredovanja

Kalendar & Zakazivanje Business +

Kalendari na vratima, upozorenja o tranzitu, mjesečeve mijene i izvoz u iCal.

GET https://api.humandesign.ai/gate-calendar
Nadogradite na Business da biste otključali
Kalendar kapije
Mjesečni kalendar koji prikazuje dnevne položaje planeta i aktivacije vrata.
parametartippotrebanOpis
YearintegerDaKalendarska godina (npr. 2024)
MonthintegerDaKalendarski mjesec (1-12)
timezonenizNeIANA vremenska zona (zadano je UTC)
GET https://api.humandesign.ai/transit-alerts
Nadogradite na Business da biste otključali
Obavještenja o tranzitu
Personalizirana upozorenja o tranzitu za natalnu kartu (do 90 dana).
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaVremenska zona rođenja
DaysintegerNeDani za predviđanje unaprijed (zadano: 30, maksimalno: 90)
GET https://api.humandesign.ai/moon-phases
Nadogradite na Business da biste otključali
Mjesečeve faze
Mjesečne mijene mjeseca i dnevne pozicije mjesečevih vrata.
parametartippotrebanOpis
YearintegerDaKalendarska godina
MonthintegerDaKalendarski mjesec (1-12)
timezonenizNeIANA vremenska zona (zadano je UTC)
GET https://api.humandesign.ai/ical-export
Nadogradite na Business da biste otključali
iCal izvoz
Izvezite prognozu tranzita kao .ics kalendarsku datoteku koju možete preuzeti.
parametartippotrebanOpis
dateISO 8601DaDatum i vrijeme rođenja
timezonenizDaVremenska zona rođenja
DaysintegerNeDani koje treba uključiti (zadano: 30, maksimalno: 90)

Referentna biblioteka

Pristupite kompletnoj HD referentnoj bazi podataka — svih 64 gejtova, 36 kanala, 9 centara i 12 profila.

GET /biblioteka/kapije
Nadogradite na Kreatora da biste otključali
Popis svih kapija
Dobijte svih 64 vrata sa sažetnim informacijama. Nisu potrebni dodatni parametri.
GET /biblioteka/kapije/{brojKapije}
Nadogradite na Kreatora da biste otključali
Detalji o kapiji
Detaljne informacije o vratima (1-64), uključujući linije, teme i opise.
parametartippotrebanOpis
gateNumbercijeli broj (putanja)DaBroj kapije (1-64)
GET /biblioteka/kanali
Nadogradite na Kreatora da biste otključali
Prikaži sve kanale
Dobijte svih 36 kanala sa sažetnim informacijama.
GET /biblioteka/kanali/{IDKanala}
Nadogradite na Kreatora da biste otključali
Detalji kanala
Detaljne informacije o kanalu (npr. "1-8").
parametartippotrebanOpis
channelIdniz (putanja)DaID kanala (npr. "1-8")
GET /biblioteka/centri
Nadogradite na Kreatora da biste otključali
Prikaži sve centre
Dobijte svih 9 centara sa sažetim informacijama.
GET /biblioteka/centri/{nazivcentra}
Nadogradite na Kreatora da biste otključali
Detalji centra
Detaljne informacije o centru (npr. "Sakralni", "G", "Solarni pleksus").
parametartippotrebanOpis
centerNameniz (putanja)DaNaziv centra (npr. "Sakralni")
GET /biblioteka/profili
Nadogradite na Kreatora da biste otključali
Prikaži sve profile
Preuzmite svih 12 profila sa sažetkom informacija.
GET /biblioteka/profili/{profilId}
Nadogradite na Kreatora da biste otključali
Detalji profila
Detaljne informacije o profilu (npr. "1/3", "4-6").
parametartippotrebanOpis
profileIdniz (putanja)DaID profila (npr. "1/3" ili "4-6")

Pretraživanje lokacije

GET https://api.humandesign.ai/locations
Nadogradite na Kreatora da biste otključali
Pretražite lokacije i vremenske zone
Pretraživanje gradova po imenu. Vraća odgovarajuće lokacije s IANA podacima o vremenskim zonama za precizne izračune grafikona. Podržava djelomične upite u stilu automatskog dovršavanja.
parametartippotrebanOpis
querynizDaGrad ili regija za pretragu (npr. "London")

Batch Processing Business +

POST https://api.humandesign.ai/batch/charts
Nadogradite na Business da biste otključali
Generiranje skupnih grafikona
Generišite do 50 grafikona u jednom zahtjevu za efikasnu masovnu obradu.
parametartippotrebanOpis
chartsarrayDaNiz objekata tipa {id?, date, timezone} (maksimalno 50)

Baza podataka slavnih osoba Business +

Pretražite i preuzmite podatke grafikona Human Designa za poznate ličnosti.

GET https://api.humandesign.ai/celebrity/search
Nadogradite na Business da biste otključali
Pretražite poznate ličnosti
Pretraži po imenu. Vraća odgovarajuće rezultate s osnovnim podacima grafikona.
parametartippotrebanOpis
querynizDaUpit za pretragu (ime)
limitintegerNeMaksimalan broj rezultata (zadano: 20, maks.: 100)
GET https://api.humandesign.ai/celebrity/{slugOrId}
Nadogradite na Business da biste otključali
Detalji o slavnim osobama
Potpuni detalji o slavnoj osobi putem korisničkog imena (npr. "elon-musk") ili UUID-a.
parametartippotrebanOpis
slugOrIdniz (putanja)DaSlavni puž ili UUID

Trebate pomoć? Kontaktirajte naš API tim na [email protected]