:id`

Busca y devuelve los datos de un producto específico por su id numérico.

🔐 Requiere autenticación JWT previa.

📍 Ruta

GET /api/products/:id

📝 Descripción

Este endpoint recupera la información de un producto identificado por su id numérico. Valida que el parámetro id sea proporcionado y que tenga el formato correcto. Si el producto existe, devuelve sus detalles; si no, responde con error 404.

🔒 Autenticación

Middleware: verificarAutenticacion

Header requerido: Authorization: Bearer <token>

🧱 Middleware Aplicado

verificarAutenticacion: Verifica el token JWT.

getProductValidator: Valida que el parámetro id sea numérico.

validateRequest: Maneja errores de validación.

🔢 Parámetros de Ruta

Parámetro	Tipo	Requerido	Descripción
`id`	number	✅	ID numérico del producto a buscar.

📤 Request Body

Ninguno.

✅ Respuestas

200 OK – Producto encontrado

{
  "status": "success",
  "code": "PRODUCT_FOUND",
  "msg": "Producto encontrado.",
  "data": {
    "id": 1,
    "product_name": "Harina",
    "measure": "kg",
    "price": 2.75,
    "stock": 80,
    "imgUrl": "https://res.cloudinary.com/..."
  }
}

❌ Errores

400 Bad Request – Parámetro ID faltante o inválido

{
  "status": "error",
  "code": "INVALID_FORMAT",
  "msg": "El id debe ser un número.",
  "errors": [/* Detalles si aplica */]
}

401 Unauthorized – Token inválido o ausente

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

404 Not Found – Producto no encontrado

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "No se encontró producto con ID 25."
}

500 Internal Server Error – Error inesperado

{
  "status": "error",
  "code": "SERVER_ERROR",
  "msg": "Ha ocurrido un error inesperado al buscar el producto. Intente de nuevo más tarde."
  // "info": { ... } // Detalles opcionales
}

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

Authorization

string

optional

Example:

Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzM4NjI4MjgxLCJleHAiOjE3Mzg2NTcwODF9.0or08xMGWjpppL1Lm2dGM6yX-5Y6ozETnKFwpXPgxxE

Visualizar Productos por ID

🔍 GET `/products/:id`

📍 Ruta

📝 Descripción

🔒 Autenticación

🧱 Middleware Aplicado

🔢 Parámetros de Ruta

📤 Request Body

✅ Respuestas

200 OK – Producto encontrado

❌ Errores

400 Bad Request – Parámetro ID faltante o inválido

401 Unauthorized – Token inválido o ausente

404 Not Found – Producto no encontrado

500 Internal Server Error – Error inesperado

Request

Responses

Visualizar Productos por ID

🔍 GET /products/:id#

📍 Ruta#

📝 Descripción#

🔒 Autenticación#

🧱 Middleware Aplicado#

🔢 Parámetros de Ruta#

📤 Request Body#

✅ Respuestas#

200 OK – Producto encontrado#

❌ Errores#

400 Bad Request – Parámetro ID faltante o inválido#

401 Unauthorized – Token inválido o ausente#

404 Not Found – Producto no encontrado#

500 Internal Server Error – Error inesperado#

Request

Responses

🔍 GET `/products/:id`

📍 Ruta

📝 Descripción

🔒 Autenticación

🧱 Middleware Aplicado

🔢 Parámetros de Ruta

📤 Request Body

✅ Respuestas

200 OK – Producto encontrado

❌ Errores

400 Bad Request – Parámetro ID faltante o inválido

401 Unauthorized – Token inválido o ausente

404 Not Found – Producto no encontrado

500 Internal Server Error – Error inesperado