Référence de l'API HumanDesign.ai Agent HTTP
Présentation
Agent HTTP expose les mêmes six opérations de calcul et de référence sous forme de points de terminaison HTTP. Utilisez-le si votre application préfère des appels HTTP nommés au protocole MCP.
Chemin de base : https://api.humandesign.ai/agent/v1/tools
Authentification
Chaque requête utilise soit Authorization: Bearer YOUR_HDAI_API_KEY ou X-Api-Key: YOUR_HDAI_API_KEY. Les identifiants dans la chaîne de requête ne sont pas pris en charge.
Points de terminaison
- POST. Chemin :
/resolve-timezone. Objectif : résoudre un lieu en fuseaux horaires et métadonnées géographiques. - POST. Chemin :
/generate-chart. Objectif : générer un schéma natal. - POST. Chemin :
/generate-composite-chart. Objectif : générer un schéma composite pour deux personnes. - POST. Chemin :
/get-reference-item. Objectif : consulter la fiche d’une porte, d’un canal, d’un centre ou d’un profil. - POST. Chemin :
/get-transits. Objectif : obtenir une prévision ou une réponse comparant le thème natal aux transits. - POST. Chemin :
/search-celebrities. Objectif : rechercher dans le catalogue des personnalités publiques.
Format de réponse
Les réponses réussies utilisent une enveloppe versionnée :
{
"version": "v1",
"tool": "generate_chart",
"data": {},
"meta": {},
"error": null
}
L’objet meta contient les informations sur la requête et le quota. Traitez les champs de réponse comme des données structurées ; n’utilisez pas le texte du résumé comme source faisant autorité.
Accès et quota
L’API vérifie les droits avant d’exécuter une opération. Une requête réussie consomme une unité API partagée. Les opérations et limites disponibles dépendent de votre niveau API actuel ; consultez les outils du catalogue MCP ou de votre compte après authentification plutôt que de vous fier à un tableau de tarifs copié.