HumanDesign.ai Agent HTTP API‑Referenz
Übersicht
Agent HTTP stellt dieselben sechs Berechnungs- und Referenzfunktionen als HTTP-Endpunkte bereit. Verwenden Sie es, wenn Ihre Anwendung benannte HTTP-Aufrufe statt des MCP-Protokolls benötigt.
Basispfad: https://api.humandesign.ai/agent/v1/tools
Authentifizierung
Für jede Anfrage wird entweder Authorization: Bearer YOUR_HDAI_API_KEY oder X-Api-Key: YOUR_HDAI_API_KEYverwendet. Anmeldedaten in Abfrageparametern werden nicht unterstützt.
Endpunkte
- POST. Pfad:
/resolve-timezone. Zweck: Einem Ort Zeitzonen- und geografische Metadaten zuordnen. - POST. Pfad:
/generate-chart. Zweck: Ein natalen Chart generieren. - POST. Pfad:
/generate-composite-chart. Zweck: Ein zweipersoniges Composite-Chart generieren. - POST. Pfad:
/get-reference-item. Zweck: Einen Datensatz zu Tor, Kanal, Zentrum oder Profil abrufen. - POST. Pfad:
/get-transits. Zweck: Eine Prognose oder einen Vergleich von Natal- und Transitdaten abrufen. - POST. Pfad:
/search-celebrities. Zweck: Im Katalog öffentlicher Personen suchen.
Antwortformat
Erfolgreiche Antworten verwenden eine versionierte Hülle:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
Das Objekt meta enthält Angaben zur Anfrage und zum Kontingent. Behandeln Sie Antwortfelder als strukturierte Daten. Der Zusammenfassungstext ist nicht die maßgebliche Quelle.
Zugriff und Kontingent
Die API prüft vor der Ausführung eines Vorgangs die Berechtigung. Eine erfolgreiche Anfrage verbraucht eine gemeinsame API-Einheit. Verfügbare Vorgänge und Limits hängen von Ihrer aktuellen API-Stufe ab. Rufen Sie die aktuelle Verfügbarkeit über den authentifizierten MCP-Katalog oder Ihre Kontotools ab, statt sich auf eine kopierte Preistabelle zu verlassen.