Revisar Historial
Consulta el historial de uso y métricas de tu cuenta API
by Arkangel AI Team•1 min read
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
- Ejemplos de Uso - Ve casos de uso completos
- Soporte - Contacta a nuestro equipo