🛒 GET `/sellers`

Obtiene una lista de todos los vendedores registrados en el sistema, devolviendo información seleccionada de cada uno.

📍 Ruta

GET /api/sellers

📝 Descripción

Este endpoint permite obtener una lista completa de todos los vendedores. Solo se retornan datos seleccionados de cada vendedor.

🔐 Autenticación

✅ Requiere token JWT válido de administrador

Encabezado: Authorization: Bearer <token>

🧰 Middleware

verificarAutenticacion

📦 Request Body

❌ No requiere cuerpo (body) en la solicitud.

✅ Respuestas

✔️ 200 OK – Vendedores obtenidos correctamente

{
  "status": "success",
  "code": "SELLERS_FETCHED",
  "msg": "Vendedores obtenidos correctamente.",
  "data": [
    {
      "_id": "ObjectId",
      "names": "string",
      "lastNames": "string",
      "cedula": number,
      "email": "string",
      "username": "string",
      "PhoneNumber": number,
      "SalesCity": "string",
      "role": "string",
      "status": boolean
    }
    // … más objetos de vendedor
  ]
}

❌ 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 los vendedores. Intente de nuevo más tarde.",
  "info": {
    "detail": "Mensaje específico del error interno (ej: 'Database connection failed')"
  }
}

curl --location --request GET 'https://back-prima-s-a.onrender.com/api/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

Visualizar Vendedores

🛒 GET `/sellers`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

📦 Request Body

✅ Respuestas

✔️ 200 OK – Vendedores obtenidos correctamente

❌ Errores

🚫 401 Unauthorized – Token inválido o ausente

💥 500 Internal Server Error – Error inesperado

Request

Responses

Visualizar Vendedores

🛒 GET /sellers#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

📦 Request Body#

✅ Respuestas#

✔️ 200 OK – Vendedores obtenidos correctamente#

❌ Errores#

🚫 401 Unauthorized – Token inválido o ausente#

💥 500 Internal Server Error – Error inesperado#

Request

Responses

🛒 GET `/sellers`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

📦 Request Body

✅ Respuestas

✔️ 200 OK – Vendedores obtenidos correctamente

❌ Errores

🚫 401 Unauthorized – Token inválido o ausente

💥 500 Internal Server Error – Error inesperado