API · Dummy Data

Dummy Users API

API REST con datos de usuarios de ejemplo. Ideal para practicar consumo de APIs, probar interfaces y desarrollar prototipos sin necesidad de un backend propio.

Base URL:https://meshicode.com/api/users
⚠️

Esta es una API de datos dummy. Los métodos POST, PUT y DELETE simulan respuestas correctas pero no persisten cambios. Los datos se reinician en cada deploy.

Endpoints

GET/api/users

Retorna la lista paginada de todos los usuarios.

Query params

NombreTipoDefaultDescripción
pagenumber1Número de página
limitnumber10Resultados por página (máx. 50)
rolestring—Filtra por rol: admin | editor | viewer
activeboolean—Filtra por estado: true | false

Respuesta de ejemplo

{
  "data": [
    {
      "id": 1,
      "firstName": "Ana",
      "lastName": "García",
      "email": "ana.garcia@example.com",
      "phone": "+52 55 1234 5678",
      "city": "Ciudad de México",
      "country": "México",
      "avatar": "https://i.pravatar.cc/150?img=1",
      "role": "admin",
      "active": true,
      "createdAt": "2024-01-15T08:30:00Z"
    }
  ],
  "meta": { "total": 10, "page": 1, "limit": 10, "totalPages": 1 }
}
GET/api/users/:id

Retorna un usuario específico por su ID.

Query params

NombreTipoDefaultDescripción
idnumber—ID del usuario (path param)

Respuesta de ejemplo

{
  "id": 1,
  "firstName": "Ana",
  "lastName": "García",
  "email": "ana.garcia@example.com",
  "phone": "+52 55 1234 5678",
  "city": "Ciudad de México",
  "country": "México",
  "avatar": "https://i.pravatar.cc/150?img=1",
  "role": "admin",
  "active": true,
  "createdAt": "2024-01-15T08:30:00Z"
}
POST/api/users

Simula la creación de un usuario. Retorna el objeto creado con un ID asignado. Los datos NO se persisten.

Body (JSON)

NombreTipoDefaultDescripción
firstNamestringNewNombre
lastNamestringUserApellido
emailstringnew@example.comCorreo electrónico
phonestring—Número de teléfono
citystring—Ciudad
countrystring—País
rolestringviewerRol: admin | editor | viewer

Respuesta de ejemplo

{
  "id": 11,
  "firstName": "Carlos",
  "lastName": "Pérez",
  "email": "carlos@example.com",
  "phone": "+52 55 0000 0000",
  "city": "Monterrey",
  "country": "México",
  "avatar": "https://i.pravatar.cc/150?img=11",
  "role": "editor",
  "active": true,
  "createdAt": "2026-06-20T12:00:00Z"
}
PUT/api/users/:id

Simula la actualización de un usuario. Retorna el objeto con los cambios aplicados. Los datos NO se persisten.

Body (JSON)

NombreTipoDefaultDescripción
idnumber—ID del usuario (path param)
...fieldsany—Cualquier campo del usuario a actualizar

Respuesta de ejemplo

{
  "id": 1,
  "firstName": "Ana",
  "lastName": "García",
  "email": "ana.new@example.com",
  "role": "editor",
  "active": true,
  "createdAt": "2024-01-15T08:30:00Z"
}
DELETE/api/users/:id

Simula la eliminación de un usuario. Retorna un mensaje de confirmación. Los datos NO se persisten.

Query params

NombreTipoDefaultDescripción
idnumber—ID del usuario (path param)

Respuesta de ejemplo

{ "message": "User 1 deleted successfully" }

Tipo: User

{
  id:        number
  firstName: string
  lastName:  string
  email:     string
  phone:     string
  city:      string
  country:   string
  avatar:    string
  role:      "admin" | "editor" | "viewer"
  active:    boolean
  createdAt: string  // ISO 8601
}

Ejemplo cURL

curl https://meshicode.com/api/users?page=1&limit=5

Notas

  • Sin autenticación requerida
  • Respuestas en JSON
  • 10 usuarios en el seed
  • IDs del 1 al 10