Endpoint /api/usage-history

URL

Descripción

Este endpoint proporciona un historial detallado del uso del servicio durante un período específico. Permite consultar el número de sesiones consumidas por mes o por rango de fechas personalizado.

Autenticación

Parámetros

Respuesta

La respuesta incluye un historial detallado del uso por períodos:

{
  "company": {
    "name": "Nombre de la empresa"
  },
  "plan": {
    "name": "Nombre del plan",
    "max_sessions": "Cantidad máxima de sesiones permitidas"
  },
  "query": {
    "period": "month",
    "startDate": "Fecha de inicio del período",
    "endDate": "Fecha de fin del período"
  },
  "stats": {
    "total_sessions": "Cantidad total de sesiones consumidas",
    "avg_sessions_per_period": "Promedio de sesiones consumidas por período",
    "periods_count": 2
  },
  "history": [
    {
      "period": "2025-06",
      "count": 4
    },
    {
      "period": "2025-07",
      "count": 25
    }
  ]
}

Ejemplos

curl -X GET "https://api.integrationit.co/api/usage-history?period=month&startDate=2025-01-01&endDate=2025-08-08" \
  -H "x-api-key: SU_API_KEY_AQUI"

// Usando fetch
const period = 'month';
const startDate = '2025-01-01';
const endDate = '2025-08-08';
const response = await fetch(`https://api.integrationit.co/api/usage-history?period=${period}&startDate=${startDate}&endDate=${endDate}`, {
  method: 'GET',
  headers: {
    'x-api-key': 'SU_API_KEY_AQUI'
  }
});

const data = await response.json();
console.log(data);

import requests

url = "https://api.integrationit.co/api/usage-history"
headers = {
    "x-api-key": "SU_API_KEY_AQUI"
}
params = {
    "period": "month",
    "startDate": "2025-01-01",
    "endDate": "2025-08-08"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())