Introduction
Lub HumanDesign.ai API qhia txog tib qho kev pabcuam xam zauv uas tau lees paub thiab muaj version uas muaj zog rau HumanDesign.ai. Siv REST rau kev sib koom ua ke ncaj qha, Agent HTTP rau cov neeg siv khoom ua haujlwm, lossis txuas tus neeg siv khoom MCP rau qhov kawg canonical root.
Cov URL tseem ceeb
https://api.humandesign.ai
https://api.humandesign.ai/agent/v1/tools/*
https://mcp.humandesign.ai/
Cov kev thov xam suav siv sib koom ib qho quota thoob plaws REST, Agent HTTP, thiab MCP thiab siv ib chav tsev tsuas yog tom qab lawv cov ntaub ntawv tiav lawm raug lees paub. Kev tshawb pom, kev tshawb nrhiav siv, MCP initialize, ping, Thiab tools/list siv xoom units.
Kev Nkag Mus Rau Qhov Kawg Los Ntawm Txoj Kev Npaj
| Qeb | creator | Pib | Lag Luam | Enterprise |
|---|
| Txhua Txoj Kev Npaj |
| Cov Ntawv Qhia Tseem Ceeb (v1) | ✓ | ✓ | ✓ | ✓ |
| Cov Daim Ntawv Qhia Txog Kev Sib Raug Zoo | ✓ | ✓ | ✓ | ✓ |
| Reference Library | ✓ | ✓ | ✓ | ✓ |
| Nrhiav qhov chaw | ✓ | ✓ | ✓ | ✓ |
| Tus Neeg Sawv Cev HTTP & MCP (Cov cuab yeej tsim) | ✓ | ✓ | ✓ | ✓ |
| Pib+ |
| Cov Duab Qhia Zoo Dua (v2, v3) | - | ✓ | ✓ | ✓ |
| Kev Thauj Mus Los & Kev Kwv Yees | - | ✓ | ✓ | ✓ |
| Cov Daim Ntawv Qhia Rov Qab | - | ✓ | ✓ | ✓ |
| Tus Neeg Sawv Cev HTTP & MCP (Cov Cuab Yeej Pib) | - | ✓ | ✓ | ✓ |
| Lag luam + |
| Calendar & Teem caij | - | - | ✓ | ✓ |
| Cov Ntaub Ntawv Txog Cov Neeg Nrov | - | - | ✓ | ✓ |
| Batch ua | - | - | ✓ | ✓ |
| Tus Neeg Sawv Cev HTTP & MCP (Cov Cuab Yeej Lag Luam) | - | - | ✓ | ✓ |
authentication
Txhua qhov kev thov yuav tsum muaj koj tus lej API hauv ib lub header kom cov ntaub ntawv pov thawj tsis tuaj yeem xau los ntawm URLs lossis cov ntawv teev lus nug. MCP txuas nrog tus account siv OAuth.
Kev Txheeb Xyuas Lub Npe (Pom Zoo)
X-Api-Key: your_api_key_here
Authorization: Bearer your_api_key_here
Tsis txhob muab cov yuam sij API tso rau hauv cov kev sib txuas, cov duab thaij, kev tshuaj xyuas, lossis cov ntawv teev cia ntawm daim ntawv thov.
Cov lej yuam kev: 401 (tsis muaj tus yuam sij), 403 (tus yuam sij tsis raug lossis tsis txaus theem), 429 (tshaj qhov quota txhua hli), 400 (kev thov tsis zoo / cov params tsis raug).
Cov Ntawv Qhia Tseem Ceeb
Tsim Daim Ntawv Qhia (v1)
Rov qab los ua ib daim ntawv qhia txog Tib Neeg Tsim uas muaj hom, txoj cai, tswv yim, profile, kev txhais, thiab txhua qhov kev qhib rooj vag.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug & sijhawm (piv txwv li 1990-05-15T14:30:00) |
timezone | txoj hlua | Yog | Lub sijhawm IANA (piv txwv li Asmeskas/New_York) |
Daim Ntawv Qhia Txhim Kho (v2) Pib+
Daim ntawv qhia txog lub cev uas zoo dua qub nrog cov khoom ntxaws ntxaws, cov ntaub ntawv qhia chaw thiab cov channel.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Lub sijhawm IANA |
Daim Ntawv Qhia Tag Nrho (v3) Pib+
Daim ntawv qhia puv ntoob nrog cov cim zodiac, retrograde status, rooj vag pawg, thiab cov lus piav qhia tag nrho.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Lub sijhawm IANA |
Cov Daim Ntawv Qhia Txog Kev Sib Raug Zoo
Daim Ntawv Qhia Sib Xyaws (v1)
Rov qab los ob daim duab qhia ib leeg thiab ib daim duab sib xyaw ua ke uas qhia txog kev sib raug zoo.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Tus Neeg A hnub yug & sijhawm |
timezone | txoj hlua | Yog | Lub sijhawm ntawm Tus Neeg A |
date1 | ISO 8601 | Yog | Tus Neeg B hnub yug thiab sijhawm |
timezone1 | txoj hlua | Yog | Lub sijhawm ntawm tus neeg B |
Kev Sib Xyaws Zoo Dua (v2)
Kev sib xyaw ua ke zoo dua nrog cov qhab nia chemistry, kev tshuaj xyuas kom ntxaws, thiab kev sib piv rooj vag.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Tus Neeg A hnub yug & sijhawm |
timezone | txoj hlua | Yog | Lub sijhawm ntawm Tus Neeg A |
date1 | ISO 8601 | Yog | Tus Neeg B hnub yug thiab sijhawm |
timezone1 | txoj hlua | Yog | Lub sijhawm ntawm tus neeg B |
Pawg Sib Xyaws
Tsim ib daim ntawv qhia sib xyaw rau 3-12 tus neeg. Zoo tagnrho rau kev tshuaj xyuas pab pawg thiab kev cob qhia pab pawg.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
members | array | Yog | Cov khoom ntawm {hnub tim, lub sijhawm} (3-12 tus neeg) |
Kev Thauj Mus Los & Kev Kwv Yees Pib+
Tshaj tawm cov chaw hla mus rau ntawm daim ntawv qhia hnub yug, tau txais cov chaw tam sim no ntawm lub ntiaj teb, thiab tsim cov kev kwv yees ntau hnub.
Daim Ntawv Qhia Txog Kev Thauj Mus Los
Tau txais daim ntawv qhia kev hla mus los uas qhia koj daim ntawv qhia natal uas muaj cov chaw hla mus los.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Hnub yug |
TransitDate | ISO 8601 | Yog | Hnub thiab sijhawm thauj mus los |
TransitTimezone | txoj hlua | Yog | Lub sijhawm ntawm qhov chaw thauj mus los |
Cov Chaw ntawm Lub Ntiaj Teb
Tau txais cov chaw nyob tam sim no nrog lub xeev kev hwm, retrograde status, thiab rooj vag activations.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Tsis yog | Hnub Tim & Sijhawm (ua ntej rau UTC tam sim no) |
timezone | txoj hlua | Tsis yog | Lub sijhawm IANA (tsis siv UTC) |
Kev Kwv Yees Txog Lub Ntiaj Teb
Kev kwv yees txhua hnub qhia txog kev hloov pauv ntawm lub rooj vag hla hnub tim (tsis pub tshaj 31 hnub).
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
StartDate | ISO 8601 | Yog | Hnub pib kwv yees |
EndDate | ISO 8601 | Yog | Hnub kawg ntawm kev kwv yees (tsis pub dhau 31 hnub) |
timezone | txoj hlua | Tsis yog | Lub sijhawm IANA (tsis siv UTC) |
Cov Daim Ntawv Qhia Rov Qab Pib+
Lub Hnub Ci, Lunar, Saturn, thiab Chiron rov qab los ntxiv rau kev nce qib thib ob.
Hnub Ci Rov Qab Los
Daim ntawv qhia rau lub sijhawm tseeb uas lub Hnub rov qab mus rau koj qhov chaw yug hauv ib xyoos.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Hnub yug |
Year | integer | Yog | Xyoo rau Lub Hnub Rov Qab Los (piv txwv li 2024) |
Kev Rov Qab Los Ntawm Lub Hli
Daim ntawv qhia rau thaum lub hli rov qab mus rau koj qhov chaw ntawm lub hli natal hauv ib lub hlis twg.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Hnub yug |
Month | txoj hlua | Yog | Lub Hlis nyob rau hauv hom ntawv YYYY-MM (piv txwv li 2024-06) |
Saturn Rov qab los
Cov ntaub ntawv thiab cov duab qhia txog Saturn Rov Qab (~ 29, ~ 58 xyoo).
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Hnub yug |
Chiron Rov Qab Los
Cov ntaub ntawv thiab daim ntawv qhia txog Chiron Rov Qab (~ 50 xyoo).
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Hnub yug |
Daim Ntawv Qhia Txog Kev Nce Qib
Daim ntawv qhia qib thib ob qhia txog kev hloov pauv mus raws sijhawm.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Hnub yug |
ProgressedTo | ISO 8601 | Yog | Hnub tim ntawm kev nce qib ntawm lub hom phiaj |
Calendar & Teem caij Lag luam +
Daim ntawv qhia hnub ntawm rooj vag, cov ceeb toom txog kev thauj mus los, theem hli, thiab iCal export.
Rooj Vag Daim Ntawv Qhia Hnub
Daim ntawv qhia hnub hli qhia txog qhov chaw ntawm lub ntiaj teb txhua hnub thiab kev qhib lub rooj vag.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
Year | integer | Yog | Xyoo (piv txwv li 2024) |
Month | integer | Yog | Lub hli (1-12) |
timezone | txoj hlua | Tsis yog | Lub sijhawm IANA (tsis siv UTC) |
Cov Ceeb Toom Txog Kev Thauj Mus Los
Cov lus ceeb toom txog kev thauj mus los rau daim ntawv qhia hnub yug (txog li 90 hnub).
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Hnub yug |
Days | integer | Tsis yog | Cov hnub uas yuav tsum tau saib ua ntej (lub neej ntawd: 30, siab tshaj plaws: 90) |
Lub hli theem
Cov theem hli txhua hli thiab cov qhov rooj ntawm lub hli txhua hnub.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
Year | integer | Yog | Daim ntawv qhia hnub xyoo |
Month | integer | Yog | Lub hli (1-12) |
timezone | txoj hlua | Tsis yog | Lub sijhawm IANA (tsis siv UTC) |
iCal Export
Xa tawm cov ntaub ntawv kwv yees kev thauj mus los ua cov ntaub ntawv .ics uas rub tau.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
date | ISO 8601 | Yog | Hnub yug thiab sijhawm |
timezone | txoj hlua | Yog | Hnub yug |
Days | integer | Tsis yog | Cov hnub suav nrog (lub neej ntawd: 30, siab tshaj: 90) |
Reference Library
Nkag mus rau tag nrho cov ntaub ntawv siv HD - tag nrho 64 lub rooj vag, 36 txoj kab ke, 9 lub chaw, thiab 12 qhov profile.
Sau Txhua Lub Rooj Vag
Tau txais tag nrho 64 lub rooj vag nrog cov ntaub ntawv luv luv. Tsis tas yuav muaj cov kev teeb tsa ntxiv.
Tau Txais Cov Ntaub Ntawv Rooj Vag
Cov ntaub ntawv qhia txog lub rooj vag (1-64) suav nrog cov kab, cov ntsiab lus, thiab cov lus piav qhia.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
gateNumber | tus lej tag nrho (txoj kev) | Yog | Tus lej rooj vag (1-64) |
Sau Txhua Txoj Kev
Tau txais tag nrho 36 txoj kev nrog cov ntaub ntawv luv luv.
Tau Txais Cov Ntaub Ntawv Qhia Txog Channel
Cov ntaub ntawv qhia txog channel kom ntxaws (piv txwv li "1-8").
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
channelId | txoj hlua (txoj kev) | Yog | Tus lej channel (piv txwv li "1-8") |
Sau Txhua Lub Chaw
Tau txais tag nrho 9 lub chaw nrog cov ntaub ntawv luv luv.
Tau Txais Cov Ntaub Ntawv Qhia Txog Chaw
Cov ntaub ntawv qhia txog qhov chaw nruab nrab (piv txwv li "Sacral", "G", "Solar Plexus").
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
centerName | txoj hlua (txoj kev) | Yog | Lub npe chaw (piv txwv li "Sacral") |
Sau Tag Nrho Cov Profiles
Tau txais tag nrho 12 qhov profile nrog cov ntaub ntawv luv luv.
Tau Txais Cov Ntaub Ntawv Qhia Txog Tus Kheej
Cov ntaub ntawv qhia txog tus kheej (piv txwv li "1/3", "4-6").
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
profileId | txoj hlua (txoj kev) | Yog | ID ntawm tus profile (piv txwv li "1/3" lossis "4-6") |
Nrhiav qhov chaw
Tshawb Nrhiav Qhov Chaw & Thaj Chaw Sijhawm
Tshawb nrhiav cov nroog los ntawm lub npe. Rov qab cov chaw sib phim nrog cov ntaub ntawv IANA lub sijhawm rau kev suav cov duab qhia kom raug. Txhawb cov lus nug ib nrab uas tsis siv neeg ua tiav.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
query | txoj hlua | Yog | Lub nroog lossis cheeb tsam uas yuav tsum tshawb nrhiav (piv txwv li "London") |
Batch ua Lag luam +
Tsim Daim Ntawv Qhia Ua Ib Pawg
Tsim kom tau txog li 50 daim duab hauv ib qho kev thov rau kev ua tiav ntau yam.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
charts | array | Yog | Cov khoom ntawm {id?, hnub tim, thaj chaw sijhawm} (siab tshaj 50) |
Cov Ntaub Ntawv Txog Cov Neeg Nrov Lag luam +
Tshawb nrhiav thiab khaws cov ntaub ntawv qhia txog Tib Neeg Tsim rau cov neeg nto moo.
Tshawb Nrhiav Cov Neeg Nrov
Tshawb nrhiav los ntawm lub npe. Rov qab cov txiaj ntsig sib phim nrog cov ntaub ntawv qhia yooj yim.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
query | txoj hlua | Yog | Kev tshawb nrhiav (lub npe) |
limit | integer | Tsis yog | Cov txiaj ntsig siab tshaj plaws (lub neej ntawd: 20, siab tshaj plaws: 100) |
Tau Txais Cov Ntaub Ntawv Txog Cov Neeg Nrov
Cov ntsiab lus ntawm cov neeg nto moo tag nrho los ntawm slug (piv txwv li "elon-musk") lossis UUID.
| parameter | hom | Yuav tsum tau | Hauj lwm |
|---|
slugOrId | txoj hlua (txoj kev) | Yog | Tus neeg nto moo slug lossis UUID |
