HumanDesign.aiPersonalAbrir app ↗
PARA VOCÊCentral de ajuda

Referência da API HTTP de agentes da HumanDesign.ai

APIAtualizado em 13 de nov. de 2026Leitura de 2 min

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.

Voltar ao topo ↑Precisa de ajuda? Fale com o suporte ↗

Encontre sua próxima resposta.