REST APIv1.0

Usuarios API

API dummy para gestión de usuarios. Ideal para prototipos, pruebas de integración y aprendizaje de consumo de APIs REST.

Base URLhttps://api.meshicode.comPróximamente

Objeto Usuario

Campo	Tipo	Descripción
id	number	Identificador único autogenerado
nombre	string	Nombre completo del usuario
email	string	Correo electrónico (único en el sistema)
telefono	string	Número de teléfono de contacto
ciudad	string	Ciudad de residencia
activo	boolean	Si el usuario está activo o desactivado

Endpoints

GET/users— Obtiene la lista de todos los usuarios registrados.

Parámetros

Nombre	Tipo	Requerido	Descripción
page	number	No	Número de página (default: 1)
limit	number	No	Resultados por página (default: 20)

Ejemplo de Request

const res = await fetch("https:255,255,255,0.35)">//api.meshicode.com/users?page=1&limit=10");
const data = await res.json();
console.log(data.users); "color:rgba(255,255,255,0.35)">// Array de usuarios

Respuesta de ejemplo

{
  "users": [
    {
      "id": 1,
      "nombre": "Juan Pérez",
      "email": "juan@example.com",
      "telefono": "555-1234",
      "ciudad": "Ciudad de México",
      "activo": true
    }
  ],
  "total": 100,
  "page": 1,
  "limit": 10
}

GET/users/:id— Obtiene los datos de un usuario específico por su ID.

Parámetros

Nombre	Tipo	Requerido	Descripción
id	number	Sí	ID único del usuario

Ejemplo de Request

const userId = 1;
const res = await fetch(`https:"color:rgba(255,255,255,0.35)">//api.meshicode.com/users/${userId}`);

if (!res.ok) throw new Error("Usuario no encontrado");
const user = await res.json();
console.log(user);

Respuesta de ejemplo

{
  "id": 1,
  "nombre": "Juan Pérez",
  "email": "juan@example.com",
  "telefono": "555-1234",
  "ciudad": "Ciudad de México",
  "activo": true
}

POST/users— Crea un nuevo usuario con los datos proporcionados.

Body (JSON)

Campo	Tipo	Requerido	Descripción
nombre	string	Sí	Nombre completo del usuario
email	string	Sí	Correo electrónico único
telefono	string	No	Número de teléfono
ciudad	string	No	Ciudad de residencia

Ejemplo de Request

const res = await fetch("https:255,255,255,0.35)">//api.meshicode.com/users", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    nombre: "Ana García",
    email: "ana@example.com",
    telefono: "555-9876",
    ciudad: "Guadalajara",
  }),
});
const nuevoUsuario = await res.json();
console.log(nuevoUsuario);

Respuesta de ejemplo

{
  "id": 2,
  "nombre": "Ana García",
  "email": "ana@example.com",
  "telefono": "555-9876",
  "ciudad": "Guadalajara",
  "activo": true
}

PUT/users/:id— Actualiza los datos de un usuario existente. Se deben enviar todos los campos.

Parámetros

Nombre	Tipo	Requerido	Descripción
id	number	Sí	ID del usuario a actualizar

Body (JSON)

Campo	Tipo	Requerido	Descripción
nombre	string	Sí	Nombre completo
email	string	Sí	Correo electrónico
telefono	string	No	Teléfono
ciudad	string	No	Ciudad
activo	boolean	No	Estado del usuario

Ejemplo de Request

const res = await fetch(`https:"color:rgba(255,255,255,0.35)">//api.meshicode.com/users/1`, {
  method: "PUT",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    nombre: "Juan Pérez López",
    email: "juan@example.com",
    activo: false,
  }),
});
const actualizado = await res.json();

Respuesta de ejemplo

{
  "id": 1,
  "nombre": "Juan Pérez López",
  "email": "juan@example.com",
  "telefono": "555-1234",
  "ciudad": "Ciudad de México",
  "activo": false
}

DELETE/users/:id— Elimina un usuario por su ID. La operación es permanente.

Parámetros

Nombre	Tipo	Requerido	Descripción
id	number	Sí	ID del usuario a eliminar

Ejemplo de Request

const res = await fetch(`https:"color:rgba(255,255,255,0.35)">//api.meshicode.com/users/1`, {
  method: "DELETE",
});

if (res.ok) {
  console.log("Usuario eliminado correctamente");
}

Respuesta de ejemplo

{
  "mensaje": "Usuario eliminado correctamente",
  "id": 1
}