:id`

Elimina un cliente específico por su identificador en MongoDB.

📍 Ruta

DELETE /api/clients/delete/:id

📝 Descripción

Este endpoint permite eliminar un cliente específico identificado por su _id en MongoDB.
Requiere autenticación mediante token JWT y valida que el parámetro id sea un ObjectId válido.
No acepta cuerpo en la solicitud.

🔐 Autenticación

Requiere autenticación JWT.

Cabecera esperada: Authorization: Bearer <token>

Middleware: verificarAutenticacion

🧰 Middleware

verificarAutenticacion – Verifica la validez del token JWT

validateDeleteClient – Valida que el parámetro id tenga formato ObjectId

validateRequest – Maneja errores de validación

🔢 Parámetros

🛣️ Path Parameters

Parámetro	Tipo	Requerido	Descripción
`id`	string	✅	`_id` del cliente en formato MongoDB ObjectId

📥 Request Body

No se requiere body.

✅ Respuestas

✔️ 200 OK – Cliente eliminado exitosamente

{
  "status": "success",
  "code": "CLIENT_DELETED",
  "msg": "Cliente eliminado con éxito."
}

❌ Errores

⚠️ 400 Bad Request – ID inválido o faltante

{
  "status": "error",
  "code": "INVALID_FORMAT",
  "msg": "El ID '{id}' no tiene un formato válido."
}

🚫 401 Unauthorized – Token inválido o ausente

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

🕳️ 404 Not Found – Cliente no encontrado

{
  "status": "error",
  "code": "NOT_FOUND",
  "msg": "No se encontró cliente con ID {id} para eliminar."
}

💥 500 Internal Server Error – Falla inesperada

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

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

curl --location --request DELETE 'https://back-prima-s-a.onrender.com/api/clients/delete/' \ --header 'User-Agent: insomnia/11.0.0' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data-raw '{ "Name": "Juan Pérez", "Address": "Av. Principal 123, Quito", "telephone": 987654321, "credit": "Rechazado", "state": "Falto" }'

Eliminar Cliente

🗑️ DELETE `/clients/delete/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Cliente eliminado exitosamente

❌ Errores

⚠️ 400 Bad Request – ID inválido o faltante

🚫 401 Unauthorized – Token inválido o ausente

🕳️ 404 Not Found – Cliente no encontrado

💥 500 Internal Server Error – Falla inesperada

Request

Responses

Eliminar Cliente

🗑️ DELETE /clients/delete/:id#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

🔢 Parámetros#

🛣️ Path Parameters#

📥 Request Body#

✅ Respuestas#

✔️ 200 OK – Cliente eliminado exitosamente#

❌ Errores#

⚠️ 400 Bad Request – ID inválido o faltante#

🚫 401 Unauthorized – Token inválido o ausente#

🕳️ 404 Not Found – Cliente no encontrado#

💥 500 Internal Server Error – Falla inesperada#

Request

Responses

🗑️ DELETE `/clients/delete/:id`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

🔢 Parámetros

🛣️ Path Parameters

📥 Request Body

✅ Respuestas

✔️ 200 OK – Cliente eliminado exitosamente

❌ Errores

⚠️ 400 Bad Request – ID inválido o faltante

🚫 401 Unauthorized – Token inválido o ausente

🕳️ 404 Not Found – Cliente no encontrado

💥 500 Internal Server Error – Falla inesperada