📄 GET `/clients`

Obtiene una lista completa de todos los clientes registrados en el sistema.

📍 Ruta

GET /api/clients

📝 Descripción

Este endpoint permite recuperar un arreglo con todos los clientes activos del sistema.
Requiere autenticación mediante token JWT válido.

🔐 Autenticación

Requiere token JWT válido

Cabecera: Authorization: Bearer <token>

Middleware: verificarAutenticacion

🧰 Middleware

verificarAutenticacion

📥 Parámetros de solicitud

URL Params

Ninguno

Query Params

Ninguno

📦 Request Body

No se requiere body.

✅ Respuestas

✔️ 200 OK – Clientes obtenidos correctamente

{
  "status": "success",
  "code": "CLIENTS_FETCHED",
  "msg": "Clientes obtenidos correctamente.",
  "data": [
    {
      "Name": "string",
      "Ruc": number,
      "Address": "string",
      "telephone": number,
      "email": "string",
      "credit": "string",
      "state": "string"
    }
    // ... más clientes
  ]
}

❌ Errores

🚫 401 Unauthorized – Token ausente o inválido

{
  "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 clientes. Intente de nuevo más tarde."
}

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

📄 GET `/clients`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

📥 Parámetros de solicitud

URL Params

Query Params

📦 Request Body

✅ Respuestas

✔️ 200 OK – Clientes obtenidos correctamente

❌ Errores

🚫 401 Unauthorized – Token ausente o inválido

💥 500 Internal Server Error – Error inesperado

Request

Responses

Visualizar Clientes

📄 GET /clients#

📍 Ruta#

📝 Descripción#

🔐 Autenticación#

🧰 Middleware#

📥 Parámetros de solicitud#

URL Params#

Query Params#

📦 Request Body#

✅ Respuestas#

✔️ 200 OK – Clientes obtenidos correctamente#

❌ Errores#

🚫 401 Unauthorized – Token ausente o inválido#

💥 500 Internal Server Error – Error inesperado#

Request

Responses

📄 GET `/clients`

📍 Ruta

📝 Descripción

🔐 Autenticación

🧰 Middleware

📥 Parámetros de solicitud

URL Params

Query Params

📦 Request Body

✅ Respuestas

✔️ 200 OK – Clientes obtenidos correctamente

❌ Errores

🚫 401 Unauthorized – Token ausente o inválido

💥 500 Internal Server Error – Error inesperado