Human Design API

Bygg på den samme validerte, versjonerte beregningstjenesten som driver HumanDesign.ai gjennom REST, normaliserte Agent HTTP-verktøy og MCP. Hver plan beholder sin publiserte kvote og nivåbaserte tilgangsgrense på tvers av alle overflater.

Kom i gang med API-et

Logg inn og abonner på en API-plan for å motta din private API-nøkkel og begynne å bygge.

Logg inn

Velg din plan

API-nøkkelen din fungerer på tvers av REST, Agent HTTP og MCP. Månedlig kvote deles på tvers av fakturerte forespørsler på alle plattformer. Grensene samsvarer med humandesignapi.com/pricing.

Gratis
$0/ mo
Endepunkter: Kjernediagrammer (v1), relasjoner, bibliotek, stedssøk, agent-HTTP og MCP-kjerne
  • 100 000 API-kall/mnd.
  • Komplett sett med funksjoner for skaperen
  • Ingen kredittkort kreves
Start gratis
Creator
$25/ mo
Endepunkter: Alt i gratis + kommersiell bruk + dashbord
  • 100 000 API-kall/mnd.
  • Kommersielt bruk
  • API-dashbord og brukssporing
Velg Plan
Mest populær
oppstart
$50/ mo
Endepunkter: Alt i Creator + komplette v3-diagrammer, transitter, returer, fremskritt
  • 100 000 API-kall/mnd.
  • Fullstendige prognoser og avkastning
  • E-poststøtte
Velg Plan
$200/ mo
Endepunkter: Alt i Oppstart + Kjendiser, Batch, Kalendere
  • 100 000 API-kall/mnd.
  • Batchbehandling
  • E-post + telefonstøtte
Velg Plan
Enterprise
Custom
Endepunkter: Full forretningstilgang på tvers av REST, Agent HTTP og MCP + tilpassede avtaler
  • Ubegrenset / tilpasset kvote
  • Tilpassede endepunkter og kontrakter
  • Dedikert støtte
Kontakt salgsavdelingen

API-dokumentasjon

Nivåbevisst referanse for REST-endepunkter, Agent HTTP-verktøy og MCP-tilgang.

Informasjon
Alle planer
Oppstart+
Business +

Introduksjon

HumanDesign.ai API eksponerer den samme validerte, versjonerte beregningstjenesten som driver HumanDesign.ai. Bruk REST for direkte integrasjoner, Agent HTTP for handlingsklienter, eller koble en MCP-klient til det kanoniske rotendepunktet.

Basis-URL-er

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

Forbrukende beregningsforespørsler deler én kvote på tvers av REST, Agent HTTP og MCP, og bruker én enhet bare etter at fullstendig inndata er validert. Oppdagelse, referanseoppslag, MCP initialize, pingog tools/list forbruker null enheter.

Endepunkttilgang etter plan

Kategori Creatoroppstart Enterprise
Alle planer
Kjernediagrammer (v1)✓✓✓✓
Relasjonsdiagrammer✓✓✓✓
Referansebibliotek✓✓✓✓
Stedsøk✓✓✓✓
Agent HTTP og MCP (verktøy for oppretting)✓✓✓✓
Oppstart+
Forbedrede diagrammer (v2, v3)-✓✓✓
Kollektivtrafikk og værmeldinger-✓✓✓
Returdiagrammer-✓✓✓
Agent HTTP og MCP (oppstartsverktøy)-✓✓✓
Business +
Kalender og planlegging--✓✓
Kjendisdatabase--✓✓
Batch Processing--✓✓
Agent HTTP og MCP (Forretningsverktøy)--✓✓

Autentisering

Hver forespørsel må inkludere API-nøkkelen din i en header, slik at legitimasjon ikke kan lekke gjennom URL-er eller spørrelogger. Den kontotilkoblede MCP-en bruker OAuth.

Topptekstgodkjenning (anbefales)

X-Api-Key: your_api_key_here
Authorization: Bearer your_api_key_here

Ikke plasser API-nøkler i lenker, skjermbilder, analyser eller applikasjonslogger.

Feilkoder: 401 (manglende nøkkel), 403 (ugyldig nøkkel eller utilstrekkelig nivå), 429 (månedlig kvote overskredet), 400 (ugyldig forespørsel / ugyldige parametere).

Kjernediagrammer

GET https://api.humandesign.ai/hd-data
Oppgrader til Creator for å låse opp
Generer diagram (v1)
Returnerer et komplett Human Design-diagram med type, autoritet, strategi, profil, definisjon og alle portaktiveringer.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett (f.eks. 1990-05-15T14:30:00)
timezonestringJaIANA-tidssone (f.eks. Amerika/New York)
GET https://api.humandesign.ai/v2/hd-data
Oppgrader til oppstart for å låse opp
Forbedret diagram (v2) Oppstart+
Forbedret fødselshoroskop med detaljerte egenskaper, utvidede sentrums- og kanaldata.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaIANA-tidssone
GET https://api.humandesign.ai/v3/hd-data
Oppgrader til oppstart for å låse opp
Fullstendig diagram (v3) Oppstart+
Det mest omfattende diagrammet med stjernetegn, retrograd status, portkategorier og full variabelterminologi.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaIANA-tidssone

Relasjonsdiagrammer

GET https://api.humandesign.ai/hd-data-composite
Oppgrader til Creator for å låse opp
Sammensatt diagram (v1)
Returnerer to individuelle diagrammer og et sammenslått komposittdiagram som viser relasjonsdynamikk.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaPerson A fødselsdato og -klokkeslett
timezonestringJaPerson A tidssone
date1ISO 8601JaPerson Bs fødselsdato og -klokkeslett
timezone1stringJaPerson B tidssone
GET https://api.humandesign.ai/v2/hd-data-composite
Oppgrader til Creator for å låse opp
Forbedret kompositt (v2)
Forbedret kompositt med kjemiscore, detaljert analyse og gate-sammenligning.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaPerson A fødselsdato og -klokkeslett
timezonestringJaPerson A tidssone
date1ISO 8601JaPerson Bs fødselsdato og -klokkeslett
timezone1stringJaPerson B tidssone
POST https://api.humandesign.ai/group-composite
Oppgrader til Creator for å låse opp
Gruppekompositt
Generer et sammensatt diagram for 3–12 personer. Ideelt for teamanalyse og gruppecoaching.
ParametertypenPåkrevdTekniske beskrivelser
membersmatriseJaMatrise med {dato, tidssone}-objekter (3–12 personer)

Kollektivtrafikk og værmeldinger Oppstart+

Legg transittposisjoner over fødselshoroskoper, få nåværende planetposisjoner og generer flerdagers prognoser.

GET https://api.humandesign.ai/hd-data-transit
Oppgrader til oppstart for å låse opp
Transittkart
Skaff deg et transitthoroskop som viser fødselshoroskopet ditt lagt over transittende planetposisjoner.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaTidssone for fødsel
TransitDateISO 8601JaDato og klokkeslett for transport
TransitTimezonestringJaTidssone for kollektivtransport
GET https://api.humandesign.ai/planetary-positions
Oppgrader til oppstart for å låse opp
Planetposisjoner
Få nåværende planetposisjoner med verdighetstilstander, retrograd status og portaktivering.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601NeiDato og klokkeslett (standard er gjeldende UTC)
timezonestringNeiIANA-tidssone (standard er UTC)
GET https://api.humandesign.ai/planetary-forecast
Oppgrader til oppstart for å låse opp
Planetarisk prognose
Daglig prognose som viser portoverganger over et datointervall (maks. 31 dager).
ParametertypenPåkrevdTekniske beskrivelser
StartDateISO 8601JaStartdato for prognose
EndDateISO 8601JaSluttdato for prognose (maks 31 dager)
timezonestringNeiIANA-tidssone (standard er UTC)

Returdiagrammer Oppstart+

Solar-, Lunar-, Saturn- og Chiron-returer pluss sekundære progresjoner.

GET https://api.humandesign.ai/solar-return
Oppgrader til oppstart for å låse opp
Solar Return
Diagram for det nøyaktige øyeblikket solen vender tilbake til din fødeposisjon i et gitt år.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaTidssone for fødsel
YearheltallJaÅr for solenergiens tilbakekomst (f.eks. 2024)
GET https://api.humandesign.ai/lunar-return
Oppgrader til oppstart for å låse opp
Månens tilbakekomst
Diagram for når månen returnerer til din fødeposisjon i en gitt måned.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaTidssone for fødsel
MonthstringJaMåned i ÅÅÅÅ-MM-format (f.eks. 2024-06)
GET https://api.humandesign.ai/saturn-return
Oppgrader til oppstart for å låse opp
Saturn kommer tilbake
Informasjon og diagrammer om Saturns tilbakekomst (~29, ~58 år).
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaTidssone for fødsel
GET https://api.humandesign.ai/chiron-return
Oppgrader til oppstart for å låse opp
Chiron Return
Informasjon og diagram for Chirons tilbakekomst (~50 år).
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaTidssone for fødsel
GET https://api.humandesign.ai/progressed-chart
Oppgrader til oppstart for å låse opp
Fremskrittsdiagram
Sekundært progressivt diagram som viser utviklingen over tid.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaTidssone for fødsel
ProgressedToISO 8601JaMåldato for progresjon

Kalender og planlegging Business +

Portkalendere, kollektivtransportvarsler, månefaser og iCal-eksport.

GET https://api.humandesign.ai/gate-calendar
Oppgrader til Business for å låse opp
Gatekalender
Månedskalender som viser daglige planetposisjoner og portaktiveringer.
ParametertypenPåkrevdTekniske beskrivelser
YearheltallJaKalenderår (f.eks. 2024)
MonthheltallJaKalendermåned (1–12)
timezonestringNeiIANA-tidssone (standard er UTC)
GET https://api.humandesign.ai/transit-alerts
Oppgrader til Business for å låse opp
Varsler om kollektivtransport
Personlige transportvarsler for et fødselshoroskop (opptil 90 dager).
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaTidssone for fødsel
DaysheltallNeiDager å se fremover (standard: 30, maks: 90)
GET https://api.humandesign.ai/moon-phases
Oppgrader til Business for å låse opp
Månefaser
Månedlige månefaser og daglige posisjoner for måneporten.
ParametertypenPåkrevdTekniske beskrivelser
YearheltallJaKalenderår
MonthheltallJaKalendermåned (1–12)
timezonestringNeiIANA-tidssone (standard er UTC)
GET https://api.humandesign.ai/ical-export
Oppgrader til Business for å låse opp
iCal-eksport
Eksporter transportvarselet som en nedlastbar .ics-kalenderfil.
ParametertypenPåkrevdTekniske beskrivelser
dateISO 8601JaFødselsdato og -klokkeslett
timezonestringJaTidssone for fødsel
DaysheltallNeiDager som skal inkluderes (standard: 30, maks: 90)

Referansebibliotek

Få tilgang til den komplette HD-referansedatabasen – alle 64 gater, 36 kanaler, 9 sentre og 12 profiler.

GET /bibliotek/porter
Oppgrader til Creator for å låse opp
List opp alle porter
Få alle 64 portene med sammendragsinformasjon. Ingen ekstra parametere kreves.
GET /bibliotek/porter/{portnummer}
Oppgrader til Creator for å låse opp
Få portdetaljer
Detaljert portinformasjon (1–64), inkludert linjer, temaer og beskrivelser.
ParametertypenPåkrevdTekniske beskrivelser
gateNumberheltall (sti)JaPortnummer (1–64)
GET /bibliotek/kanaler
Oppgrader til Creator for å låse opp
List opp alle kanaler
Få alle 36 kanalene med sammendragsinformasjon.
GET /bibliotek/kanaler/{kanalId}
Oppgrader til Creator for å låse opp
Få kanaldetaljer
Detaljert kanalinformasjon (f.eks. «1–8»).
ParametertypenPåkrevdTekniske beskrivelser
channelIdstreng (sti)JaKanal-ID (f.eks. «1–8»)
GET /bibliotek/sentre
Oppgrader til Creator for å låse opp
List opp alle sentre
Få alle 9 sentre med sammendragsinformasjon.
GET /bibliotek/sentre/{senternavn}
Oppgrader til Creator for å låse opp
Få senterdetaljer
Detaljert senterinformasjon (f.eks. «Sacral», «G», «Solar Plexus»).
ParametertypenPåkrevdTekniske beskrivelser
centerNamestreng (sti)JaSenternavn (f.eks. «Sakral»)
GET /bibliotek/profiler
Oppgrader til Creator for å låse opp
List opp alle profiler
Få alle 12 profilene med sammendragsinformasjon.
GET /bibliotek/profiler/{profil-ID}
Oppgrader til Creator for å låse opp
Få profildetaljer
Detaljert profilinformasjon (f.eks. «1/3», «4–6»).
ParametertypenPåkrevdTekniske beskrivelser
profileIdstreng (sti)JaProfil-ID (f.eks. «1/3» eller «4–6»)

Stedsøk

GET https://api.humandesign.ai/locations
Oppgrader til Creator for å låse opp
Søk etter steder og tidssoner
Søk etter byer etter navn. Returnerer samsvarende steder med IANA-tidssonedata for nøyaktige diagramberegninger. Støtter delvise søk i autofullføringsstil.
ParametertypenPåkrevdTekniske beskrivelser
querystringJaBy eller region å søke etter (f.eks. «London»)

Batch Processing Business +

POST https://api.humandesign.ai/batch/charts
Oppgrader til Business for å låse opp
Generering av batchdiagrammer
Generer opptil 50 diagrammer i én forespørsel for effektiv massebehandling.
ParametertypenPåkrevdTekniske beskrivelser
chartsmatriseJaMatrise med {id?, dato, tidssone}-objekter (maks. 50)

Kjendisdatabase Business +

Søk og hent Human Design-diagramdata for kjendiser.

GET https://api.humandesign.ai/celebrity/search
Oppgrader til Business for å låse opp
Søk etter kjendiser
Søk etter navn. Returnerer samsvarende resultater med grunnleggende diagramdata.
ParametertypenPåkrevdTekniske beskrivelser
querystringJaSøkeforespørsel (navn)
limitheltallNeiMaks. resultater (standard: 20, maks: 100)
GET https://api.humandesign.ai/celebrity/{slugOrId}
Oppgrader til Business for å låse opp
Få kjendisdetaljer
Fullstendige kjendisdetaljer etter slug (f.eks. «elon-musk») eller UUID.
ParametertypenPåkrevdTekniske beskrivelser
slugOrIdstreng (sti)JaKjendissnegle eller UUID

Trenger du hjelp? Kontakt API-teamet vårt på [email protected]