API Statistiques d'Entreprise

Obtenez des statistiques d'utilisation complètes pour votre entreprise en utilisant nos SDK officiels.

📊 Aperçu

Obtenez des insights détaillés sur l'utilisation des secrets de votre entreprise, les patterns de création et les métriques de sécurité. Toutes les statistiques sont automatiquement limitées à votre entreprise et gérées de manière transparente par nos SDK.

SDK Officiels :

Outil CLI C# - Interface en ligne de commande multiplateforme
JavaScript SDK - Pour Node.js et les applications web modernes
JavaScript CDN - Intégration navigateur simple
Python SDK - Client Python asynchrone

📈 Obtenir les Statistiques d'Entreprise

Récupérez des statistiques complètes pour l'utilisation des secrets de votre entreprise.

Utilisation SDK

CLI C#JavaScript SDKJavaScript CDNPython SDK

bash

sharokey stats

javascript

const stats = await client.getStats();

javascript

const stats = await Sharokey.getStats();

python

stats = await client.get_stats()

Format de Réponse

json

{
  "success": true,
  "message": "Statistiques des secrets récupérées avec succès",
  "data": {
    "total_secrets": 1247,
    "active_secrets": 89,
    "expired_secrets": 1158,
    "total_views": 5432,
    "secrets_with_password": 156,
    "secrets_created_today": 12,
    "secrets_created_this_week": 87,
    "secrets_created_this_month": 234
  },
  "meta": {
    "version": "v1",
    "timestamp": "2025-08-11T08:33:42.208967Z"
  }
}

Champs Statistiques

Champ	Type	Description
`total_secrets`	integer	Nombre total de secrets créés par votre entreprise
`active_secrets`	integer	Secrets qui ne sont pas expirés et n'ont pas atteint la limite de vues
`expired_secrets`	integer	Secrets qui ont expiré ou atteint le maximum de vues
`total_views`	integer	Nombre total de fois que les secrets ont été vus
`secrets_with_password`	integer	Nombre de secrets protégés avec des mots de passe additionnels
`secrets_created_today`	integer	Secrets créés dans les dernières 24 heures
`secrets_created_this_week`	integer	Secrets créés dans les derniers 7 jours
`secrets_created_this_month`	integer	Secrets créés dans les derniers 30 jours

Calcul du Statut

Définition d'un Secret Actif :

Date d'expiration dans le futur (ou nulle)
Vues actuelles < vues maximum
Pas supprimé manuellement

Définition d'un Secret Expiré :

Date d'expiration passée, OU
Vues actuelles >= vues maximum, OU
Supprimé manuellement (contenu effacé)

🔍 Insights Statistiques

Patterns d'Utilisation

Indicateurs de Forte Activité :

secrets_created_today > 10
secrets_created_this_week > 50
Ratio élevé de secrets_with_password (utilisation soucieuse de la sécurité)

Métriques de Sécurité :

Taux de Protection par Mot de Passe : secrets_with_password / total_secrets * 100
Efficacité des Vues : total_views / total_secrets (vues moyennes par secret)
Taux d'Expiration : expired_secrets / total_secrets * 100

Analyse de Rétention

Ratio Actifs vs. Total :

Taux d'Actifs = (active_secrets / total_secrets) * 100

Taux d'Actifs Élevé (>20%) : Usage récent, temps d'expiration plus longs
Taux d'Actifs Bas (<5%) : Secrets de courte durée, posture de sécurité élevée

📊 Recommandations d'Usage

Meilleures Pratiques de Sécurité

Si secrets_with_password < 30% de total_secrets :

Considérez implémenter la protection par mot de passe pour le contenu sensible
Révisez les politiques de sécurité avec les membres de l'équipe

Si active_secrets > 50% de total_secrets :

Révisez les politiques d'expiration - les secrets vivent peut-être trop longtemps
Considérez des temps d'expiration par défaut plus courts

Optimisation des Performances

Usage à Haut Volume (secrets_created_today > 50) :

Surveillez attentivement les limites de taux API
Considérez implémenter des files d'attente de requêtes côté client
Utilisez les opérations en masse quand disponibles

🚨 Réponses d'Erreur

Tous les SDK gèrent ces erreurs automatiquement et fournissent des objets d'erreur structurés.

Erreur d'Authentification

json

{
  "success": false,
  "error": {
    "code": "AUTHENTICATION_ERROR",
    "message": "Token invalide ou expiré"
  }
}

Erreur de Permission

json

{
  "success": false,
  "error": {
    "code": "PERMISSION_DENIED",
    "message": "Permissions insuffisantes pour lire les stats de l'entreprise"
  }
}

Rate Limit Dépassé

json

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Trop de requêtes. Veuillez réessayer plus tard."
  }
}

🔐 Sécurité & Confidentialité

Isolation d'Entreprise

Statistiques automatiquement filtrées pour votre entreprise
Aucune fuite de données inter-entreprises possible
Portée du token appliquée automatiquement par les SDK

Confidentialité des Données

Les statistiques n'incluent pas le contenu ou métadonnées des secrets
Seuls les comptages agrégés et dates sont retournés
Détails des secrets individuels non exposés

💡 Exemples d'Intégration

CLI C#JavaScript SDKJavaScript CDNPython SDK

bash

# Obtenez les stats et formatez pour l'affichage
sharokey stats --format json | jq '.data.total_secrets'

javascript

// Récupérer et afficher les stats de l'entreprise
const stats = await client.getStats();
document.getElementById('total-secrets').textContent = stats.total_secrets;
document.getElementById('active-secrets').textContent = stats.active_secrets;

javascript

// Mise à jour simple du tableau de bord
const stats = await Sharokey.getStats();
console.log(`Secrets actifs : ${stats.active_secrets}`);

python

# Calculer les métriques de sécurité
stats = await client.get_stats()
password_rate = (stats.secrets_with_password / stats.total_secrets) * 100
print(f"Taux de protection par mot de passe : {password_rate:.1f}%")

Surveillance CLI

bash

# Vérifier la création quotidienne de secrets
DAILY_COUNT=$(sharokey stats --field secrets_created_today)
if [ "$DAILY_COUNT" -gt 100 ]; then
  echo "Usage élevé détecté : $DAILY_COUNT secrets créés aujourd'hui"
fi

Reporting Automatisé

JavaScript SDKPython SDK

javascript

// Rapport d'usage hebdomadaire
const stats = await client.getStats();
const report = {
  weekly_creation: stats.secrets_created_this_week,
  security_score: (stats.secrets_with_password / stats.total_secrets) * 100,
  active_ratio: (stats.active_secrets / stats.total_secrets) * 100
};
console.log('Rapport Hebdomadaire :', report);

python

# Analyse de sécurité
stats = await client.get_stats()
analysis = {
    'password_protection_rate': (stats.secrets_with_password / stats.total_secrets) * 100,
    'activity_level': 'high' if stats.secrets_created_today > 10 else 'normal',
    'retention_health': 'good' if stats.active_secrets / stats.total_secrets < 0.2 else 'review'
}
print(f"Analyse de Sécurité : {analysis}")

🔗 Documentation Liée

API Secrets - Gestion des secrets individuels
Documentation CLI C# - Statistiques en ligne de commande
JavaScript SDK - Intégration des stats
Python SDK - Méthodes d'analytics
Authentification - Gestion des tokens API

Toutes les statistiques sont calculées en temps réel et reflètent l'état actuel de l'utilisation des secrets de votre entreprise.

API Statistiques d'Entreprise ​

📊 Aperçu ​

📈 Obtenir les Statistiques d'Entreprise ​

Utilisation SDK ​

Format de Réponse ​

Champs Statistiques ​

Calcul du Statut ​

🔍 Insights Statistiques ​

Patterns d'Utilisation ​

Analyse de Rétention ​

📊 Recommandations d'Usage ​

Meilleures Pratiques de Sécurité ​

Optimisation des Performances ​

🚨 Réponses d'Erreur ​

Erreur d'Authentification ​

Erreur de Permission ​

Rate Limit Dépassé ​

🔐 Sécurité & Confidentialité ​

Isolation d'Entreprise ​

Confidentialité des Données ​

💡 Exemples d'Intégration ​

Widget de Tableau de Bord ​

Surveillance CLI ​

Reporting Automatisé ​

🔗 Documentation Liée ​

API Statistiques d'Entreprise

📊 Aperçu

📈 Obtenir les Statistiques d'Entreprise

Utilisation SDK

Format de Réponse

Champs Statistiques

Calcul du Statut

🔍 Insights Statistiques

Patterns d'Utilisation

Analyse de Rétention

📊 Recommandations d'Usage

Meilleures Pratiques de Sécurité

Optimisation des Performances

🚨 Réponses d'Erreur

Erreur d'Authentification

Erreur de Permission

Rate Limit Dépassé

🔐 Sécurité & Confidentialité

Isolation d'Entreprise

Confidentialité des Données

💡 Exemples d'Intégration

Widget de Tableau de Bord

Surveillance CLI

Reporting Automatisé

🔗 Documentation Liée