Retour à la documentation

Consulter l'Historique

Consultez l'historique d'utilisation et les métriques de votre compte API

par Arkangel AI Team•1 min de lecture

Surveillez l'utilisation de votre API et accédez aux métriques détaillées de votre compte.

Historique d'Utilisation

Point d'Accès

GET https://api.arkangelai.com/v1/usage

Exemple

curl https://api.arkangelai.com/v1/usage \
  -H "Authorization: Bearer votre_cle_api"

Paramètres

Paramètre Type Description
start_date string Date de début (AAAA-MM-JJ)
end_date string Date de fin (AAAA-MM-JJ)
granularity string day, week, ou month

Réponse

{
  "usage": {
    "period": {
      "start": "2026-01-01",
      "end": "2026-01-19"
    },
    "total_requests": 1250,
    "total_tokens": 45000,
    "successful_requests": 1240,
    "failed_requests": 10
  },
  "daily_breakdown": [
    {
      "date": "2026-01-19",
      "requests": 85,
      "tokens": 3200
    }
  ]
}

Métriques par Point d'Accès

curl "https://api.arkangelai.com/v1/usage/endpoints?start_date=2026-01-01" \
  -H "Authorization: Bearer votre_cle_api"

Réponse

{
  "endpoints": [
    {
      "endpoint": "/v1/chat",
      "requests": 800,
      "avg_latency_ms": 450,
      "error_rate": 0.5
    },
    {
      "endpoint": "/v1/files",
      "requests": 150,
      "avg_latency_ms": 200,
      "error_rate": 0.2
    }
  ]
}

Limites et Quotas

Vérifier les Limites Actuelles

curl https://api.arkangelai.com/v1/usage/limits \
  -H "Authorization: Bearer votre_cle_api"

Réponse

{
  "plan": "professional",
  "limits": {
    "requests_per_day": 10000,
    "requests_used_today": 85,
    "tokens_per_month": 1000000,
    "tokens_used_this_month": 45000,
    "file_storage_mb": 500,
    "file_storage_used_mb": 125
  },
  "reset_times": {
    "daily": "2026-01-20T00:00:00Z",
    "monthly": "2026-02-01T00:00:00Z"
  }
}

Historique des Erreurs

curl "https://api.arkangelai.com/v1/usage/errors?limit=20" \
  -H "Authorization: Bearer votre_cle_api"

Réponse

{
  "errors": [
    {
      "timestamp": "2026-01-19T10:30:00Z",
      "endpoint": "/v1/chat",
      "status_code": 429,
      "error_type": "rate_limit_exceeded",
      "request_id": "req_xyz789"
    }
  ],
  "total": 10
}

Exporter les Données d'Utilisation

Exportez votre historique d'utilisation pour analyse :

curl "https://api.arkangelai.com/v1/usage/export?format=csv&start_date=2026-01-01" \
  -H "Authorization: Bearer votre_cle_api" \
  -o utilisation_api.csv

Formats Disponibles

Format Description
csv Valeurs séparées par des virgules
json Données structurées JSON

Alertes d'Utilisation

Configurez des alertes lorsque vous atteignez certains seuils :

curl -X POST https://api.arkangelai.com/v1/usage/alerts \
  -H "Authorization: Bearer votre_cle_api" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "usage_threshold",
    "threshold_percent": 80,
    "notify_email": "votre@email.com"
  }'

Exemple Complet

async function getUsageReport() {
  const today = new Date().toISOString().split('T')[0];
  const monthStart = today.substring(0, 8) + '01';

  // Obtenir l'utilisation du mois
  const usageResponse = await fetch(
    `https://api.arkangelai.com/v1/usage?start_date=${monthStart}&end_date=${today}`,
    {
      headers: {
        'Authorization': 'Bearer votre_cle_api'
      }
    }
  );

  const usage = await usageResponse.json();

  // Obtenir les limites
  const limitsResponse = await fetch(
    'https://api.arkangelai.com/v1/usage/limits',
    {
      headers: {
        'Authorization': 'Bearer votre_cle_api'
      }
    }
  );

  const limits = await limitsResponse.json();

  return {
    usage: usage.usage,
    limits: limits.limits,
    percentUsed: (usage.usage.total_tokens / limits.limits.tokens_per_month) * 100
  };
}

Prochaines Étapes