Volver a la documentación

Revisar Historial

Consulta el historial de uso y métricas de tu cuenta API

por Arkangel AI Team•1 min de lectura

Monitorea el uso de tu API y accede a métricas detalladas de tu cuenta.

Historial de Uso

Endpoint

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

Ejemplo

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

Parámetros

Parámetro Tipo Descripción
start_date string Fecha de inicio (YYYY-MM-DD)
end_date string Fecha de fin (YYYY-MM-DD)
granularity string day, week, o month

Respuesta

{
  "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étricas por Endpoint

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

Respuesta

{
  "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
    }
  ]
}

Límites y Cuotas

Consultar Límites Actuales

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

Respuesta

{
  "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"
  }
}

Historial de Errores

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

Respuesta

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

Exportar Datos de Uso

Exporta tu historial de uso para análisis:

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

Formatos Disponibles

Formato Descripción
csv Valores separados por comas
json Datos estructurados JSON

Alertas de Uso

Configura alertas cuando alcances ciertos umbrales:

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

Ejemplo Completo

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

  // Obtener uso del mes
  const usageResponse = await fetch(
    `https://api.arkangelai.com/v1/usage?start_date=${monthStart}&end_date=${today}`,
    {
      headers: {
        'Authorization': 'Bearer tu_clave_api'
      }
    }
  );

  const usage = await usageResponse.json();

  // Obtener límites
  const limitsResponse = await fetch(
    'https://api.arkangelai.com/v1/usage/limits',
    {
      headers: {
        'Authorization': 'Bearer tu_clave_api'
      }
    }
  );

  const limits = await limitsResponse.json();

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

Próximos Pasos