Informe del panel - Solicitudes de API consolidadas

Datos e informes
, ,
1

Este es una versión SQL del Informe del Panel para Solicitudes de API Consolidadas.

Este informe muestra estadísticas de uso de la API por fecha, rastreando tanto las solicitudes de API regulares como las solicitudes de API de usuario. Este informe le ayuda a monitorear los patrones de uso de la API en su instancia de Discourse a lo largo del tiempo. Distingue entre solicitudes de API regulares y solicitudes de API de usuario, mostrando ambas por separado junto con el recuento total combinado.

Los datos provienen de la tabla application_requests, que rastrea diferentes tipos de solicitudes en todo el sistema. Para el uso de la API, nos centramos en los tipos de solicitud 11 (API regular) y 12 (API de usuario).

-- [params]
-- date :start_date = 2023-01-01
-- date :end_date = 2025-12-31

SELECT 
  ar.date,
  -- Solicitudes de API
  SUM(CASE WHEN ar.req_type = 11 THEN ar.count ELSE 0 END) AS api,
  SUM(CASE WHEN ar.req_type = 12 THEN ar.count ELSE 0 END) AS user_api,
  -- Solicitudes de API totales
  SUM(CASE WHEN ar.req_type IN (11, 12) THEN ar.count ELSE 0 END) AS total_api_requests
FROM 
  application_requests ar
WHERE 
  ar.date BETWEEN :start_date AND :end_date
GROUP BY 
  ar.date
ORDER BY 
  ar.date DESC

Parámetros:

  • La consulta acepta dos parámetros, :start_date y :end_date, que definen el rango de fechas para el informe. Ambos parámetros de fecha aceptan el formato de fecha YYYY-MM-DD.

Resultados

  • date: Fecha de los recuentos de solicitudes
  • api: Recuento de solicitudes de API regulares (req_type = 11)
  • user_api: Recuento de solicitudes de API de usuario (req_type = 12)
  • total_api_requests: Suma de todas las solicitudes de API

¿Cuál es la diferencia entre las solicitudes de API regulares y las de API de usuario?

  • Solicitudes de API regulares (req_type = 11): Estas son llamadas a la API realizadas al sistema que no requieren autenticación de usuario. Incluyen puntos de conexión de API públicos, integraciones de sistemas o servicios de terceros que acceden a datos públicos.
  • Solicitudes de API de usuario (req_type = 12): Estas son llamadas a la API realizadas con autenticación de usuario, lo que generalmente representa acciones realizadas en nombre de usuarios específicos y requiere el uso de una clave API.

Resultados de ejemplo

date api user_api total_api_requests
2023-09-15 34,582 7,249 41,831
2023-09-14 32,104 6,893 38,997
2023-09-13 33,756 7,122 40,878
2023-09-12 35,122 8,562 43,684
2023-09-11 36,475 9,234 45,709
2023-09-10 12,563 3,298 15,861
2023-09-09 10,782 2,982 13,764
2023-09-08 33,892 7,456 41,348
2023-09-07 31,765 7,120 38,885
2023-09-06 32,451 7,321 39,772
6 Me gusta