Prima-Back
  1. Modulo Productos
Prima-Back
  • API DOCUMENTATION
  • Principal
    • /
      GET
  • Modulo Administradores
    • Vendedores Operaciones
      • Registro de Vendedores
      • Visualizar Vendedores
      • Visualizar Vendedores por Mongo ID
      • Visualizar Vendedores por cedula
      • Actualizar Vendedor
      • Eliminar Vendedor
    • Estadisticas
      • Estadisticas de documentos
      • Visualizacion de top Vendedores
      • Visualizar Ventas por Vendedor
    • Login Administradores
      POST
    • Recuperacion de contraseña Administrador
      POST
  • Modulo Vendedores
    • Inicio de Sesión Vendedores
      POST
    • Confirmación de Cuenta
      GET
    • Solicitud de restablecimiento de contraseña
      POST
    • Restablecimiento de contraseña
      POST
  • Modulo Clientes
    • Registrar Cliente
      POST
    • Visualizar Clientes
      GET
    • Visualizar Clientes por RUC
      GET
    • Actualizar Cliente
      PATCH
    • Eliminar Cliente
      DELETE
  • Modulo Productos
    • Crear Producto
      POST
    • Visualizar Productos
      GET
    • Visualizar Productos por ID
      GET
    • Actualizar Producto
      PATCH
    • Eliminar Producto
      DELETE
  • Modulo Pedidos
    • Crear Orden
      POST
    • Visualizar Ordenes
      GET
    • Visualizar Ordenes por ID
      GET
    • Actualizar Orden
      PATCH
    • Actualizar Estado de Orden
      PATCH
    • Eliminar Orden
      DELETE
  1. Modulo Productos

Visualizar Productos

GET
/api/products/

📦 GET /products#

Obtiene la lista completa de productos registrados en el sistema.
🔐 Requiere autenticación JWT previa.

📍 Ruta#

GET /api/products

📝 Descripción#

Este endpoint devuelve un listado de todos los productos almacenados en la base de datos. Cada producto incluye sus datos principales y la URL de su imagen, si tiene una.

🔒 Autenticación#

Middleware: verificarAutenticacion
Header requerido: Authorization: Bearer <token>

🧱 Middleware Aplicado#

1.
verificarAutenticacion: Verifica el token JWT.

📥 Parámetros de Solicitud#

Ninguno.

📤 Request Body#

Ninguno.

✅ Respuestas#

200 OK – Productos obtenidos correctamente#

{
  "status": "success",
  "code": "PRODUCTS_FETCHED",
  "msg": "Productos obtenidos correctamente.",
  "data": [
    {
      "id": 1,
      "product_name": "Manzana",
      "measure": "kg",
      "price": 3.5,
      "stock": 120,
      "imgUrl": "https://res.cloudinary.com/..."
    },
    {
      "id": 2,
      "product_name": "Leche",
      "measure": "litro",
      "price": 1.2,
      "stock": 50,
      "imgUrl": ""
    }
    // ...
  ]
}

❌ Errores#

401 Unauthorized – Token inválido o ausente#

{
  "status": "error",
  "code": "AUTH_ERROR",
  "msg": "Acceso no autorizado. Se requiere token válido."
}

500 Internal Server Error – Error inesperado#

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al obtener los productos. Intente de nuevo más tarde."
  // "info": { ... } // Detalles opcionales
}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://back-prima-s-a.onrender.com/api/products/' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE'
Response Response Example
{}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Header Params
Authorization
string 
optional
Example:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE

Responses

🟢200Success
application/json
Body
object {0}
Modified at 2025-04-24 16:57:38
Previous
Crear Producto
Next
Visualizar Productos por ID
Built with