Dokumentacja HTTP API agenta HumanDesign.ai
Przegląd
Agent HTTP udostępnia te same sześć operacji obliczeniowych i referencyjnych jako punkty końcowe HTTP. Wybierz go, jeśli aplikacja ma korzystać z nazwanych wywołań HTTP zamiast protokołu MCP.
Ścieżka bazowa: https://api.humandesign.ai/agent/v1/tools
Uwierzytelnianie
Każde żądanie używa Authorization: Bearer YOUR_HDAI_API_KEY lub X-Api-Key: YOUR_HDAI_API_KEY. Dane uwierzytelniające w ciągu zapytania nie są obsługiwane.
Punkty końcowe
- POST. Ścieżka:
/resolve-timezone. Cel: określenie stref czasowych i metadanych geograficznych dla lokalizacji. - POST. Ścieżka:
/generate-chart. Cel: wygenerowanie wykresu urodzeniowego. - POST. Ścieżka:
/generate-composite-chart. Cel: wygenerowanie dwuosobowego wykresu kompozytowego. - POST. Ścieżka:
/get-reference-item. Cel: pobranie rekordu bramy, kanału, centrum lub profilu. - POST. Ścieżka:
/get-transits. Cel: pobranie prognozy lub odpowiedzi porównującej wykres urodzeniowy z tranzytem. - POST. Ścieżka:
/search-celebrities. Cel: przeszukanie katalogu osób publicznych.
Format odpowiedzi
Pomyślne odpowiedzi korzystają z wersjonowanej koperty:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
Obiekt meta zawiera informacje o żądaniu i limicie. Traktuj pola odpowiedzi jako dane uporządkowane; nie odczytuj tekstu podsumowania jako źródła prawdy.
Dostęp i limit
API sprawdza uprawnienia przed wykonaniem operacji. Pomyślne żądanie zużywa jedną wspólną jednostkę API. Dostępne operacje i limity zależą od bieżącego poziomu API; aktualną dostępność sprawdzaj w uwierzytelnionym katalogu MCP lub narzędziach konta, a nie w skopiowanej tabeli cen.