Passer au contenu principal

API AthenaHQ

L’API AthenaHQ vous permet d’interagir avec la plateforme par programmation et à grande échelle. Créez des intégrations personnalisées, automatisez vos processus et étendez les capacités d’AthenaHQ pour répondre aux besoins de votre organisation.

Authentification

Toutes les requêtes API nécessitent une authentification par clé API. Vous gérez les clés dans le tableau de bord de votre organisation et pouvez limiter leur portée à certains sites web pour contrôler précisément les accès.

Créer des clés API

Générez et gérez vos clés API dans les paramètres de votre organisation
Pour en savoir plus sur les méthodes d’authentification et la gestion des clés API, consultez la documentation Authentification.

Dates et fuseaux horaires

Sauf indication contraire, tous les horodatages transmis à l’API et renvoyés par celle-ci sont exprimés en UTC.

Programmations de collecte

Les analyses de réponses sélectionnent une seule programmation à la fois. Utilisez filters.schedule_id dans les requêtes JSON : default (également utilisé si le champ est omis), manual ou l’UUID d’une programmation personnalisée. La programmation par défaut inclut tout l’historique antérieur à la transition. Les programmations archivées conservent leurs résultats. filters.schedule_id accepte exactement une programmation et renvoie 400 si vous fournissez une liste. Deux autres méthodes permettent de combiner plusieurs programmations, y compris celles qui sont archivées. Les outils MCP query_metrics et query_rows acceptent un tableau dans schedule, par exemple ["default", "<schedule UUID>"]. Les endpoints de métriques appliquent aussi une vue enregistrée contenant plusieurs programmations lorsque vous la transmettez dans filters.saved_view_id. Si vous envoyez également filters.schedule_id, cette programmation unique remplace celles de la vue. Les programmations s’exécutent à des fréquences différentes ; leurs totaux et tendances combinés mélangent donc ces fréquences. Découvrez les programmations disponibles avec GET /api/v1/prompt-schedules?website_id=... et utilisez la valeur selection de chaque ligne. Pour GET /api/v1/date-range, transmettez cette valeur dans le paramètre de requête schedule_id. L’équivalent MCP est get_prompt_schedules.