Referencia de la API Agent HTTP de HumanDesign.ai
Resumen
Agent HTTP ofrece las mismas seis operaciones de cálculo y referencia que los endpoints HTTP. Úsalo cuando tu aplicación necesite llamadas HTTP con nombres específicos en lugar del protocolo MCP.
Ruta base: https://api.humandesign.ai/agent/v1/tools
Autenticación
Cada solicitud utiliza Authorization: Bearer YOUR_HDAI_API_KEY o X-Api-Key: YOUR_HDAI_API_KEY. No se admiten credenciales en la cadena de consulta.
Endpoints
- POST. Ruta:
/resolve-timezone. Propósito: resolver una ubicación y obtener zonas horarias y metadatos geográficos. - POST. Ruta:
/generate-chart. Propósito: generar una carta natal. - POST. Ruta:
/generate-composite-chart. Propósito: generar una carta compuesta de dos personas. - POST. Ruta:
/get-reference-item. Propósito: consultar un registro de puerta, canal, centro o perfil. - POST. Ruta:
/get-transits. Propósito: obtener una respuesta de pronóstico o de comparación entre carta natal y tránsitos. - POST. Ruta:
/search-celebrities. Propósito: buscar en el catálogo de figuras públicas.
Formato de respuesta
Las respuestas exitosas utilizan un contenedor versionado:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
El objeto meta incluye información sobre la solicitud y la cuota. Trata los campos de respuesta como datos estructurados; no uses el texto del resumen como fuente de verdad.
Acceso y cuota
La API comprueba los permisos antes de ejecutar una operación. Cada solicitud exitosa consume una unidad API compartida. Las operaciones disponibles y sus límites dependen de tu nivel API actual; consulta la disponibilidad vigente mediante el catálogo MCP autenticado o las herramientas de tu cuenta, en lugar de basarte en una tabla de precios copiada.