Les API d’analyse fournissent des indicateurs agrégés sur l’utilisation et l’activité d’un espace de travail ChatGPT. L’API unifiée d’analyse de l’utilisation quotidienne fournit des indicateurs d’utilisation pour ChatGPT, Codex et le mode Work, jour par jour. Avant d’utiliser ce point de terminaison, vérifiez qu’il est activé pour votre espace de travail.
La documentation de référence de l’API d’administration fait foi pour les conditions d’accès en vigueur, les routes, les schémas de requête et de réponse, les indicateurs, l’interprétation des données temporelles et la pagination.
Quand utiliser l’API d’analyse
L’API d’analyse convient si vous souhaitez :
- Automatiser la production de rapports périodiques sur l’utilisation de l’espace de travail.
- Croiser les indicateurs d’utilisation agrégés avec les données internes de votre organisation.
- Mettre en place un système de rapports dont l’accès est réservé aux publics autorisés.
- Éviter qu’une intégration dépende d’un tableau de bord interactif.
Cette API ne donne pas accès aux journaux d’audit bruts. Utilisez l’API de conformité lorsque votre workflow exige des enregistrements d’activité vérifiables lors d’un audit.
Vérifiez la portée des accès d’administration
Les résultats de l’API d’analyse se limitent à un espace de travail ChatGPT. Pour l’API unifiée d’analyse de l’utilisation quotidienne, utilisez une clé d’administration limitée à cet espace de travail et dotée de l’autorisation enterprise.analytics.usage.read. L’autorisation Codex codex.enterprise.analytics.read ne donne pas accès à ce point de terminaison.
La documentation de référence de l’API précise comment obtenir les clés et quelles autorisations sont requises. Elle décrit également les routes, les schémas, les champs, l’interprétation des données temporelles et le fonctionnement de la pagination. Cette page ne reprend pas ces spécifications.