HumanDesign.ai Agent HTTP API‑referens
Översikt
Agent HTTP erbjuder samma sex beräknings- och referensåtgärder som HTTP-slutpunkter. Använd det när din applikation vill göra namngivna HTTP-anrop i stället för att använda MCP-protokollet.
Bassökväg: https://api.humandesign.ai/agent/v1/tools
Autentisering
Varje förfrågan använder antingen Authorization: Bearer YOUR_HDAI_API_KEY eller X-Api-Key: YOUR_HDAI_API_KEY . Autentiseringsuppgifter i frågesträngen stöds inte.
Slutpunkter
- POST . Sökväg:
/resolve-timezone. Syfte: Slå upp en plats och returnera tidszoner och geografiska metadata. - POST . Sökväg:
/generate-chart. Syfte: Skapa ett födelsediagram. - POST . Sökväg:
/generate-composite-chart. Syfte: Skapa ett kompositdiagram för två personer. - POST . Sökväg:
/get-reference-item. Syfte: Hämta en post för gate, kanal, center eller profil. - POST . Sökväg:
/get-transits. Syfte: Hämta en prognos eller ett svar för födelsediagram kontra transit. - POST . Sökväg:
/search-celebrities. Syfte: Sök i katalogen över offentliga personer.
Svarformat
Lyckade svar använder ett versionshanterat kuvert:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
Objektet meta innehåller information om förfrågan och kvoten. Behandla svarsfälten som strukturerade data; använd inte sammanfattningstexten som källa till sanningen.
Åtkomst och kvot
API:et kontrollerar behörighet innan en åtgärd körs. En lyckad förfrågan förbrukar en gemensam API-enhet. Tillgängliga åtgärder och gränser beror på din aktuella API-nivå; hämta aktuell tillgänglighet via den autentiserade MCP-katalogen eller dina kontoverktyg i stället för att förlita dig på en kopierad pristabell.