HumanDesign.ai Agent HTTP API‑referanse
Oversikt
Agent HTTP tilbyr de samme seks beregnings- og referanseoperasjonene som HTTP-endepunkter. Bruk det når applikasjonen vil foreta navngitte HTTP-kall i stedet for å bruke MCP-protokollen.
Basisbane: https://api.humandesign.ai/agent/v1/tools
Autentisering
Hver forespørsel bruker enten Authorization: Bearer YOUR_HDAI_API_KEY eller X-Api-Key: YOUR_HDAI_API_KEY . Legitimasjon i spørringsstrengen støttes ikke.
Endepunkter
- POST . Bane:
/resolve-timezone. Formål: Slå opp et sted og returner tidssoner og geografiske metadata. - POST . Bane:
/generate-chart. Formål: Generer et fødselshoroskop. - POST . Bane:
/generate-composite-chart. Formål: Generer et komposittdiagram for to personer. - POST . Bane:
/get-reference-item. Formål: Hent en oppføring for en port, kanal, senter eller profil. - POST . Bane:
/get-transits. Formål: Hent en prognose eller et svar for fødselshoroskop mot transitt. - POST . Bane:
/search-celebrities. Formål: Søk i katalogen over offentlige personer.
Svarformat
Vellykkede svar bruker en versjonsstyrt konvolutt:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
Objektet meta inneholder informasjon om forespørsel og kvote. Behandle svarfeltene som strukturerte data; ikke bruk sammendragsteksten som kilde til sannheten.
Tilgang og kvote
API-et kontrollerer rettigheter før en operasjon kjøres. En vellykket forespørsel bruker én delt API-enhet. Tilgjengelige operasjoner og grenser avhenger av API-nivået ditt. Hent gjeldende tilgjengelighet fra den autentiserte MCP-katalogen eller kontoverktøyene i stedet for å stole på en kopiert prisliste.