HumanDesign.aiPersonalApri l'app ↗
PER TECentro assistenza

Riferimento API HTTP per agenti HumanDesign.ai

APIAggiornato il 13 novembre 20262 min di lettura

Panoramica

Agent HTTP espone le stesse sei operazioni di calcolo e riferimento degli endpoint HTTP. Usalo quando l’applicazione richiede chiamate HTTP denominate anziché il protocollo MCP.

Percorso base: https://api.humandesign.ai/agent/v1/tools

Autenticazione

Ogni richiesta utilizza Authorization: Bearer YOUR_HDAI_API_KEY oppure X-Api-Key: YOUR_HDAI_API_KEY. Le credenziali nella stringa di query non sono supportate.

Endpoint

  • POST. Percorso: /resolve-timezone. Scopo: risolvere una località ottenendo fusi orari e metadati geografici.
  • POST. Percorso: /generate-chart. Scopo: generare un grafico natale.
  • POST. Percorso: /generate-composite-chart. Scopo: generare un grafico composito di due persone.
  • POST. Percorso: /get-reference-item. Scopo: leggere una voce relativa a porta, canale, centro o profilo.
  • POST. Percorso: /get-transits. Scopo: ottenere una previsione o una risposta natale rispetto ai transiti.
  • POST. Percorso: /search-celebrities. Scopo: cercare nel catalogo dei personaggi pubblici.

Formato della risposta

Le risposte riuscite utilizzano un contenitore versionato:

{
  "version": "v1",
  "tool": "generate_chart",
  "data": {},
  "meta": {},
  "error": null
}

L’oggetto meta include informazioni sulla richiesta e sulla quota. Considera i campi della risposta come dati strutturati; non interpretare il testo del riepilogo come fonte di verità.

Accesso e quota

L’API verifica i permessi prima di eseguire un’operazione. Ogni richiesta riuscita consuma un’unità API condivisa. Le operazioni disponibili e i relativi limiti dipendono dal livello API attuale; recupera la disponibilità aggiornata dal catalogo MCP autenticato o dagli strumenti dell’account, anziché affidarti a una tabella dei prezzi copiata.

Torna all'inizio ↑Ti serve aiuto? Contatta l'assistenza ↗

Trova la prossima risposta.