Consulter l'Historique

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

• Exemples d'Utilisation - Voir des cas d'utilisation complets
• Support - Contactez notre équipe