Riferimento API HTTP per agenti HumanDesign.ai
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.