Human Design API

Rakenna samalle validoidulle ja versioidulle laskentapalvelulle, joka tukee HumanDesign.ai:ta RESTin, normalisoitujen Agent HTTP -työkalujen ja MCP:n kautta. Jokainen paketti säilyttää julkaistun käyttöoikeusrajoituksensa ja tasopohjaisen käyttöoikeusrajansa kaikilla pinnoilla.

Aloita API:n käyttö

Kirjaudu sisään ja tilaa API-paketti saadaksesi yksityisen API-avaimesi ja aloittaaksesi rakentamisen.

Kirjaudu sisään

Valitse Your Plan

API-avaimesi toimii RESTin, Agent HTTP:n ja MCP:n kautta. Kuukausittainen kiintiö jaetaan laskutettujen pyyntöjen kesken kaikilla alustoilla. Rajat vastaavat humandesignapi.com/pricing -sivustoa.

Ilmainen
$0/ kk
Päätepisteet: Ydinkaaviot (v1), Suhde, Kirjasto, Sijaintihaku, Agentin HTTP- ja MCP-ydin
  • 100 000 API-kutsua/kk
  • Täydellinen luojan ominaisuuspaketti
  • Luottokorttia ei vaadita
Aloita ilmaiseksi
Luoja
$25/ kk
Päätepisteet: Kaikki ilmaiseksi + kaupalliseen käyttöön + kojelautaan
  • 100 000 API-kutsua/kk
  • Kaupallinen käyttö
  • API-hallintapaneeli ja käytön seuranta
Valitse Plan
Suosituin
Startup
$50/ kk
Päätepisteet: Kaikki Creatorissa + täydelliset v3-kaaviot, läpikulut, paluut, eteneminen
  • 100 000 API-kutsua/kk
  • Täydelliset ennusteet ja tuotot
  • Sähköposti tuki
Valitse Plan
Bisnes
$200/ kk
Päätepisteet: Kaikki Startupissa + Julkkikset, Erät, Kalenterit
  • 100 000 API-kutsua/kk
  • Eräkäsittely
  • Sähköposti- ja puhelintuki
Valitse Plan
yritys
Mittatilaus
Päätepisteet: Täydet liiketoiminnan oikeudet REST-, Agent HTTP- ja MCP-rajapintoihin sekä mukautetut sopimukset
  • Rajoittamaton / mukautettu kiintiö
  • Mukautetut päätepisteet ja sopimukset
  • Omistettu tuki
Ota yhteyttä myyjään

API-dokumentaatio

Tasokohtainen viite REST-päätepisteille, agentin HTTP-työkaluille ja MCP-käytölle.

general
Kaikki suunnitelmat
Startup+
Business +

esittely

HumanDesign.ai-rajapinta tarjoaa saman validoidun ja versioidun laskentapalvelun, joka tukee HumanDesign.ai:ta. Käytä REST-protokollaa suoriin integraatioihin, Agent HTTP -protokollaa toimintoasiakkaille tai yhdistä MCP-asiakasohjelma kanoniseen juuripäätepisteeseen.

Perus-URL-osoitteet

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

Kuluttavat laskentapyynnöt jakavat yhden kiintiön RESTin, Agent HTTP:n ja MCP:n kesken ja käyttävät yhtä yksikköä vasta sen jälkeen, kun niiden koko syöte on validoitu. Löytö, viitehaku, MCP initialize, pingja tools/list kuluttaa nolla yksikköä.

Päätepisteiden käyttöoikeus sopimuksen mukaan

Luokka LuojaStartupBisnesyritys
Kaikki suunnitelmat
Ydinkaaviot (v1)✓✓✓✓
Suhdekaaviot✓✓✓✓
Käsikirjasto✓✓✓✓
Sijaintihaku✓✓✓✓
Agentin HTTP ja MCP (Luojatyökalut)✓✓✓✓
Startup+
Parannetut kaaviot (v2, v3)-✓✓✓
Liikenne ja ennustaminen-✓✓✓
Paluukaaviot-✓✓✓
Agentin HTTP ja MCP (käynnistystyökalut)-✓✓✓
Business +
Kalenteri ja aikataulutus--✓✓
Julkkistietokanta--✓✓
Eräkäsittely--✓✓
Agentin HTTP ja MCP (liiketoimintatyökalut)--✓✓

Authentication

Jokaisen pyynnön on sisällettävä API-avaimesi otsikkoon, jotta tunnistetiedot eivät voi vuotaa URL-osoitteiden tai kyselylokien kautta. Tiliin yhdistetty MCP käyttää OAuth-todennusta.

Ylätunnisteen todennus (suositus)

X-Api-Key: your_api_key_here
Authorization: Bearer your_api_key_here

Älä sijoita API-avaimia linkkeihin, kuvakaappauksiin, analytiikkaan tai sovelluslokeihin.

Virhekoodit: 401 (puuttuva avain), 403 (virheellinen avain tai riittämätön taso), 429 (kuukausittainen kiintiö ylitetty), 400 (virheellinen pyyntö / virheelliset parametrit).

Ydinkaaviot

SAA https://api.humandesign.ai/hd-data
Päivitä Creator-tasolle avataksesi
Luo kaavio (v1)
Palauttaa täydellisen Human Design -kaavion, joka sisältää tyypin, auktoriteetin, strategian, profiilin, määritelmän ja kaikki porttiaktivoinnit.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika (esim. 1990-05-15T14:30:00)
timezonejonoKylläIANA-aikavyöhyke (esim. Amerikka/New_York)
SAA https://api.humandesign.ai/v2/hd-data
Päivitä käynnistysversioon avataksesi
Parannettu kaavio (v2) Startup+
Parannettu syntymäkartta yksityiskohtaisilla ominaisuuksilla, laajennetuilla keskus- ja kanavatiedoilla.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläIANA-aikavyöhyke
SAA https://api.humandesign.ai/v3/hd-data
Päivitä käynnistysversioon avataksesi
Koko kaavio (v3) Startup+
Kattavin kaavio, joka sisältää horoskooppimerkit, perääntymistilan, porttiluokat ja täydellisen muuttujien terminologian.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläIANA-aikavyöhyke

Suhdekaaviot

SAA https://api.humandesign.ai/hd-data-composite
Päivitä Creator-tasolle avataksesi
Yhdistelmäkaavio (v1)
Palauttaa kaksi yksittäistä kaaviota ja yhdistetyn yhdistelmäkaavion, joka näyttää suhdedynamiikan.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläHenkilön A syntymäaika ja -aika
timezonejonoKylläHenkilö A:n aikavyöhyke
date1ISO 8601KylläHenkilö B:n syntymäaika ja -aika
timezone1jonoKylläHenkilö B:n aikavyöhyke
SAA https://api.humandesign.ai/v2/hd-data-composite
Päivitä Creator-tasolle avataksesi
Parannettu komposiitti (v2)
Parannettu yhdistelmä kemiallisilla pisteillä, yksityiskohtaisella analyysillä ja porttivertailun avulla.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläHenkilön A syntymäaika ja -aika
timezonejonoKylläHenkilö A:n aikavyöhyke
date1ISO 8601KylläHenkilö B:n syntymäaika ja -aika
timezone1jonoKylläHenkilö B:n aikavyöhyke
POST https://api.humandesign.ai/group-composite
Päivitä Creator-tasolle avataksesi
Ryhmäkomposiitti
Luo yhdistelmäkaavio 3–12 henkilölle. Ihanteellinen tiimianalyysiin ja ryhmävalmennukseen.
ParametriTyyppiedellytetäänTuotetiedot
membersryhmäKyllä{date, timezone} -objektien taulukko (3–12 henkilöä)

Liikenne ja ennustaminen Startup+

Lisää planeettojen siirtymäsijainnit päällekkäin syntymäkarttoihin, hae planeettojen nykyiset sijainnit ja luo usean päivän ennusteita.

SAA https://api.humandesign.ai/hd-data-transit
Päivitä käynnistysversioon avataksesi
Joukkoliikennekaavio
Hanki transiittikartta, joka näyttää syntymäkarttasi päällekkäin transiittiplaneettojen sijainnit.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläSyntymäaikavyöhyke
TransitDateISO 8601KylläJulkisen liikenteen päivämäärä ja aika
TransitTimezonejonoKylläJulkisen liikenteen sijainnin aikavyöhyke
SAA https://api.humandesign.ai/planetary-positions
Päivitä käynnistysversioon avataksesi
Planeettojen asemat
Hanki planeettojen nykyiset sijainnit arvokkuustiloilla, perääntymistilalla ja porttiaktivoinneilla.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601EiPäivämäärä ja aika (oletuksena nykyinen UTC-aika)
timezonejonoEiIANA-aikavyöhyke (oletusarvo UTC)
SAA https://api.humandesign.ai/planetary-forecast
Päivitä käynnistysversioon avataksesi
Planeettaennuste
Päivittäinen ennuste, joka näyttää porttisiirtymät tietyllä ajanjaksolla (enintään 31 päivää).
ParametriTyyppiedellytetäänTuotetiedot
StartDateISO 8601KylläEnnusteen aloituspäivämäärä
EndDateISO 8601KylläEnnusteen päättymispäivämäärä (enintään 31 päivää)
timezonejonoEiIANA-aikavyöhyke (oletusarvo UTC)

Paluukaaviot Startup+

Aurinko-, kuu-, Saturnus- ja Chiron-palautukset sekä toissijaiset progressiot.

SAA https://api.humandesign.ai/solar-return
Päivitä käynnistysversioon avataksesi
Aurinkoenergian tuotto
Kaavio tarkasta hetkestä, jolloin Aurinko palaa syntymäpaikkaasi tiettynä vuonna.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläSyntymäaikavyöhyke
YearkokonaislukuKylläAurinkoenergian paluuvuosi (esim. 2024)
SAA https://api.humandesign.ai/lunar-return
Päivitä käynnistysversioon avataksesi
Kuun paluu
Kaavio siitä, milloin Kuu palaa syntymäpaikkaasi tietyssä kuussa.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläSyntymäaikavyöhyke
MonthjonoKylläKuukausi muodossa VVVV-KK (esim. 2024-06)
SAA https://api.humandesign.ai/saturn-return
Päivitä käynnistysversioon avataksesi
Saturnuksen paluu
Saturnuksen paluutiedot ja -kaaviot (~29, ~58 vuotta).
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläSyntymäaikavyöhyke
SAA https://api.humandesign.ai/chiron-return
Päivitä käynnistysversioon avataksesi
Chironin paluu
Chironin paluutiedot ja -kaavio (~50 vuotta).
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläSyntymäaikavyöhyke
SAA https://api.humandesign.ai/progressed-chart
Päivitä käynnistysversioon avataksesi
Edistymiskaavio
Toissijaisen edistymisen kaavio, joka näyttää kehityksen ajan kuluessa.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläSyntymäaikavyöhyke
ProgressedToISO 8601KylläTavoite-etenemispäivämäärä

Kalenteri ja aikataulutus Business +

Porttikalenterit, joukkoliikennehälytykset, kuun vaiheet ja iCal-vienti.

SAA https://api.humandesign.ai/gate-calendar
Päivitä Business-versioon avataksesi
Porttikalenteri
Kuukausikalenteri, joka näyttää päivittäiset planeettojen sijainnit ja porttiaktivoinnit.
ParametriTyyppiedellytetäänTuotetiedot
YearkokonaislukuKylläKalenterivuosi (esim. 2024)
MonthkokonaislukuKylläKalenterikuukausi (1–12)
timezonejonoEiIANA-aikavyöhyke (oletusarvo UTC)
SAA https://api.humandesign.ai/transit-alerts
Päivitä Business-versioon avataksesi
Julkisen liikenteen hälytykset
Synnytyskaavion mukaiset henkilökohtaiset liikennehälytykset (jopa 90 päivää).
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläSyntymäaikavyöhyke
DayskokonaislukuEiPäivää tulevaan (oletus: 30, maksimi: 90)
SAA https://api.humandesign.ai/moon-phases
Päivitä Business-versioon avataksesi
Kuun vaiheet
Kuukauden vaiheet ja päivittäiset kuuporttien sijainnit.
ParametriTyyppiedellytetäänTuotetiedot
YearkokonaislukuKylläKalenterivuosi
MonthkokonaislukuKylläKalenterikuukausi (1–12)
timezonejonoEiIANA-aikavyöhyke (oletusarvo UTC)
SAA https://api.humandesign.ai/ical-export
Päivitä Business-versioon avataksesi
iCal-vienti
Vie joukkoliikenteen ennuste ladattavana .ics-kalenteritiedostona.
ParametriTyyppiedellytetäänTuotetiedot
dateISO 8601KylläSyntymäaika ja -aika
timezonejonoKylläSyntymäaikavyöhyke
DayskokonaislukuEiSisällytettävät päivät (oletus: 30, enint.: 90)

Käsikirjasto

Käytä koko HD-viitetietokantaa — kaikki 64 porttia, 36 kanavaa, 9 keskusta ja 12 profiilia.

SAA /kirjasto/portit
Päivitä Creator-tasolle avataksesi
Listaa kaikki portit
Saat kaikki 64 porttia yhteenvetotietoineen. Lisäparametreja ei tarvita.
SAA /kirjasto/portit/{porttiNumber}
Päivitä Creator-tasolle avataksesi
Hae portin tiedot
Yksityiskohtaiset porttitiedot (1–64), mukaan lukien linjat, teemat ja kuvaukset.
ParametriTyyppiedellytetäänTuotetiedot
gateNumberkokonaisluku (polku)KylläPortin numero (1-64)
SAA /kirjasto/kanavat
Päivitä Creator-tasolle avataksesi
Listaa kaikki kanavat
Hanki kaikki 36 kanavaa yhteenvetotietoineen.
SAA /kirjasto/kanavat/{kanavanTunnus}
Päivitä Creator-tasolle avataksesi
Hae kanavan tiedot
Tarkat kanavatiedot (esim. "1-8").
ParametriTyyppiedellytetäänTuotetiedot
channelIdmerkkijono (polku)KylläKanavan tunnus (esim. "1-8")
SAA /kirjasto/keskukset
Päivitä Creator-tasolle avataksesi
Listaa kaikki keskukset
Hanki kaikki 9 keskusta yhteenvetotietoineen.
SAA /kirjasto/keskukset/{keskuksenNimi}
Päivitä Creator-tasolle avataksesi
Hanki keskuksen tiedot
Tarkemmat tiedot keskuksesta (esim. "Sakrali", "G", "Aurinkopunnos").
ParametriTyyppiedellytetäänTuotetiedot
centerNamemerkkijono (polku)KylläKeskuksen nimi (esim. "Sakrali")
SAA /kirjasto/profiilit
Päivitä Creator-tasolle avataksesi
Listaa kaikki profiilit
Hanki kaikki 12 profiilia yhteenvetotietoineen.
SAA /kirjasto/profiilit/{profiilinTunnus}
Päivitä Creator-tasolle avataksesi
Hanki profiilitiedot
Yksityiskohtaiset profiilitiedot (esim. "1/3", "4-6").
ParametriTyyppiedellytetäänTuotetiedot
profileIdmerkkijono (polku)KylläProfiilitunnus (esim. "1/3" tai "4-6")

Sijaintihaku

SAA https://api.humandesign.ai/locations
Päivitä Creator-tasolle avataksesi
Hae sijainteja ja aikavyöhykkeitä
Hae kaupunkeja nimen perusteella. Palauttaa vastaavat sijainnit IANA-aikavyöhykedatan mukaisesti tarkkojen kaaviolaskelmien tekemiseksi. Tukee automaattisesti täydennettäviä osittaisia ​​kyselyitä.
ParametriTyyppiedellytetäänTuotetiedot
queryjonoKylläHaettava kaupunki tai alue (esim. "Lontoo")

Eräkäsittely Business +

POST https://api.humandesign.ai/batch/charts
Päivitä Business-versioon avataksesi
Eräkaavion luonti
Luo jopa 50 kaaviota yhdellä pyynnöllä tehokasta joukkokäsittelyä varten.
ParametriTyyppiedellytetäänTuotetiedot
chartsryhmäKyllä{id?, date, timezone} -objektien taulukko (enintään 50)

Julkkistietokanta Business +

Hae ja hae julkkisten Human Design -kaaviotietoja.

SAA https://api.humandesign.ai/celebrity/search
Päivitä Business-versioon avataksesi
Hae julkkiksia
Hae nimen perusteella. Palauttaa vastaavat tulokset, joissa on peruskaavion tiedot.
ParametriTyyppiedellytetäänTuotetiedot
queryjonoKylläHakukysely (nimi)
limitkokonaislukuEiMaksimitulokset (oletus: 20, maksimi: 100)
SAA https://api.humandesign.ai/celebrity/{slugOrId}
Päivitä Business-versioon avataksesi
Hanki julkkistietoja
Julkkiksen täydelliset tiedot etanan (esim. "elon-musk") tai UUID:n mukaan.
ParametriTyyppiedellytetäänTuotetiedot
slugOrIdmerkkijono (polku)KylläJulkkis-etana tai UUID

Tarvitsetko apua? Ota yhteyttä API-tiimiimme osoitteessa [email protected]