Referência da API HTTP de agentes da HumanDesign.ai
Visão geral
O Agent HTTP expõe as mesmas seis operações de cálculo e referência como endpoints HTTP. Use-o quando seu aplicativo precisar de chamadas HTTP nomeadas em vez do protocolo MCP.
Caminho base: https://api.humandesign.ai/agent/v1/tools
Autenticação
Cada solicitação usa Authorization: Bearer YOUR_HDAI_API_KEY ou X-Api-Key: YOUR_HDAI_API_KEY. Credenciais na query string não são aceitas.
Endpoints
- POST. Caminho:
/resolve-timezone. Finalidade: resolver uma localização em fusos horários e metadados geográficos. - POST. Caminho:
/generate-chart. Finalidade: gerar um mapa natal. - POST. Caminho:
/generate-composite-chart. Finalidade: gerar um mapa composto de duas pessoas. - POST. Caminho:
/get-reference-item. Finalidade: consultar um registro de portão, canal, centro ou perfil. - POST. Caminho:
/get-transits. Finalidade: obter uma previsão ou uma resposta de natal versus trânsito. - POST. Caminho:
/search-celebrities. Finalidade: pesquisar o catálogo de figuras públicas.
Formato da resposta
Respostas bem-sucedidas usam um envelope versionado:
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
O objeto meta inclui informações sobre a solicitação e a cota. Trate os campos da resposta como dados estruturados; não use o texto do resumo como fonte definitiva.
Acesso e cota
A API verifica os direitos antes de executar uma operação. Uma solicitação bem-sucedida consome uma unidade compartilhada da API. As operações disponíveis e os limites dependem do seu nível atual; consulte a disponibilidade atual no catálogo MCP autenticado ou nas ferramentas da sua conta em vez de confiar em uma tabela de preços copiada.