top-sellers`

Obtiene el top 5 de vendedores con mayor número de órdenes registradas, ordenados de menor a mayor cantidad de ventas.

📍 Ruta

GET /api/statics/top-sellers

📝 Descripción

Devuelve dos arrays:

sellerNames: nombres completos de los vendedores.

salesCounts: número de ventas correspondientes.

El orden va de menor a mayor número de órdenes realizadas.

🔐 Autenticación

✅ Requiere autenticación.

Token JWT en cabecera:
Authorization: Bearer <token>

Middleware: verificarAutenticacion

📦 Request Body

❌ No se requiere body.

✅ Respuestas

✔️ 200 OK – Top 5 vendedores obtenido exitosamente

{
  "status": "success",
  "code": "TOP_SELLERS_FOUND",
  "msg": "Top 5 de vendedores obtenido exitosamente.",
  "data": {
    "sellerNames": [
      "Nombre Apellido Vendedor 3",
      "Nombre Apellido Vendedor 5",
      "Nombre Apellido Vendedor 1",
      "Nombre Apellido Vendedor 4",
      "Nombre Apellido Vendedor 2"
    ],
    "salesCounts": [
      15,
      22,
      28,
      35,
      41
    ]
  }
}

❌ Errores

🔒 401 Unauthorized – Token inválido o ausente

{
  "status": "error",
  "code": "UNAUTHORIZED",
  "msg": "Acceso no autorizado. Se requiere token de autenticación válido."
}

💥 500 Internal Server Error – Error inesperado

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al obtener el top de vendedores. Intente de nuevo más tarde."
}

curl --location --request GET 'https://back-prima-s-a.onrender.com/api/statics/top-sellers' \ --header 'User-Agent: insomnia/10.3.0' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE'

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Header Params

User-Agent

string

optional

Example:

insomnia/10.3.0

Authorization

string

optional

Example:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE

Visualizacion de top Vendedores

🥇 GET `/statics/top-sellers`

📍 Ruta

📝 Descripción

🔐 Autenticación

📦 Request Body

✅ Respuestas

✔️ 200 OK – Top 5 vendedores obtenido exitosamente

❌ Errores

🔒 401 Unauthorized – Token inválido o ausente

💥 500 Internal Server Error – Error inesperado

Request

Responses

Visualizacion de top Vendedores

🥇 GET /statics/top-sellers#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

📦 Request Body#

✅ Respuestas#

✔️ 200 OK – Top 5 vendedores obtenido exitosamente#

❌ Errores#

🔒 401 Unauthorized – Token inválido o ausente#

💥 500 Internal Server Error – Error inesperado#

Request

Responses

🥇 GET `/statics/top-sellers`

📍 Ruta

📝 Descripción

🔐 Autenticación

📦 Request Body

✅ Respuestas

✔️ 200 OK – Top 5 vendedores obtenido exitosamente

❌ Errores

🔒 401 Unauthorized – Token inválido o ausente

💥 500 Internal Server Error – Error inesperado