Eliminar Cliente
DELETE
/api/clients/delete/{id}
🗑️ DELETE /clients/delete/:id
📍 Ruta
DELETE /api/clients/delete/:id📝 Descripción
_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
Authorization: Bearer <token>verificarAutenticacion🧰 Middleware
1.
verificarAutenticacion – Verifica la validez del token JWT2.
validateDeleteClient – Valida que el parámetro id tenga formato ObjectId3.
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
✅ 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."
}Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://back-prima-s-a.onrender.com/api/clients/delete/' \
--header 'User-Agent: insomnia/11.0.0' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyOTMxNzg3LCJleHAiOjE3NDI5NjA1ODd9.nwBdY2DmiTAjEYfxGukAQHJkbrsLHqMosjmOSgzfbR4' \
--header 'Content-Type: application/json' \
--data-raw '{
"Name": "Juan Pérez",
"Address": "Av. Principal 123, Quito",
"telephone": 987654321,
"credit": "Rechazado",
"state": "Falto"
}'Response Response Example
{"message":"Cliente eliminado con éxito"}Request
Path Params
id
string
required
Header Params
Content-Type
string
optional
Example:
application/json
User-Agent
string
optional
Example:
insomnia/11.0.0
Authorization
string
optional
Example:
Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6IjY3NjI0ZjkwNzY2OWM5MDZjYTM0YThkZSIsInJvbCI6ImFkbWluIiwiaWF0IjoxNzQyOTMxNzg3LCJleHAiOjE3NDI5NjA1ODd9.nwBdY2DmiTAjEYfxGukAQHJkbrsLHqMosjmOSgzfbR4
Body Params application/json
Responses
Modified at 2025-04-24 17:57:27