Sanggunian ng HumanDesign.ai Agent HTTP API
Pangkalahatang-ideya
Inilalantad ng Agent HTTP bilang mga HTTP endpoint ang parehong anim na calculation at reference operation. Gamitin ito kapag gusto ng application mo ng pinangalanang HTTP call sa halip na MCP protocol.
Base path: https://api.humandesign.ai/agent/v1/tools
Pagpapatunay
Gumagamit ang bawat request ng alinman sa Authorization: Bearer YOUR_HDAI_API_KEY o X-Api-Key: YOUR_HDAI_API_KEY. Hindi sinusuportahan ang credential sa query string.
Mga Endpoint
- POST. Path:
/resolve-timezone. Layunin: Iresolba ang lokasyon sa mga timezone at geographic metadata. - POST. Path:
/generate-chart. Layunin: Bumuo ng natal chart. - POST. Path:
/generate-composite-chart. Layunin: Bumuo ng composite chart para sa dalawang tao. - POST. Path:
/get-reference-item. Layunin: Basahin ang rekord ng gate, channel, center o profile. - POST. Path:
/get-transits. Layunin: Kumuha ng forecast o tugon na natal-versus-transit. - POST. Path:
/search-celebrities. Layunin: Maghanap sa katalogo ng mga pampublikong personalidad.
Format ng tugon
Gumagamit ang matagumpay na tugon ng versioned na envelope:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
Ang meta kasama sa object ang impormasyon ng request at quota. Ituring na nakaayos na data ang mga field ng tugon; huwag suriin ang summary text bilang pangunahing sanggunian.
Access at quota
Sinusuri ng API ang entitlement bago patakbuhin ang operasyon. Gumagamit ng iisang pinagsasaluhang API unit ang matagumpay na request. Depende ang mga available na operasyon at limitasyon sa kasalukuyang API tier mo; kunin ang kasalukuyang availability sa authenticated na MCP catalog o mga tool ng account mo sa halip na umasa sa kinopyang talahanayan ng presyo.