> ## Documentation Index
> Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction

> Interagissez avec AthenaHQ et intégrez la plateforme par programmation

## 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.

> [card] [Créer des clés API](https://app.athenahq.ai/organization?tab=api)
>
> Générez et gérez vos clés API dans les paramètres de votre organisation

> [!NOTE]
>
> Pour en savoir plus sur les méthodes d’authentification et la gestion des clés
> API, consultez la documentation
> [Authentification](https://docs.athenahq.ai/fr/api-reference/authentication.md).

## 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`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.