Si estás construyendo una interfaz de usuario antes de que exista el backend, necesitas datos para renderizar, y DummyJSON es una de las formas más rápidas de obtenerlos. Es una API REST falsa, gratuita y alojada que sirve productos, usuarios, carritos y más realistas a través de HTTP simple, sin necesidad de registro. Esta guía explica qué te ofrece DummyJSON, cómo se compara con otras APIs públicas de prueba, y qué hacer cuando los datos de marcador de posición fijos ya no son suficientes.
¿Qué es DummyJSON?
DummyJSON es una API JSON de marcador de posición gratuita. Envías una solicitud a un endpoint público y devuelve datos de muestra estructurados y creíbles. No hay una base de datos que configurar ni una clave que registrar. Existe para que los desarrolladores frontend, estudiantes y cualquier persona que esté prototipando puedan acceder a un endpoint de red real en lugar de codificar arrays en su código.
Los datos son falsos pero coherentes. Un producto tiene un título, precio, calificación, recuento de stock y categoría. Un usuario tiene un nombre, correo electrónico, dirección y empresa. Esa coherencia hace que DummyJSON sea útil para conectar tablas, tarjetas, paginación y páginas de detalles que se parecen a la realidad. Debido a que los registros están anidados y tipados de la misma manera que suelen estar los datos de producción, puedes construir filtros, controles de ordenación y vistas de detalle sin tener que inventar tus propios datos de prueba primero.
DummyJSON sirve todo a través de HTTPS como JSON, por lo que funciona igual desde una solicitud de navegador, una aplicación móvil, un comando curl o un script del lado del servidor. No hay nada que instalar. Apuntas una solicitud a una URL y recibes datos, que es exactamente lo que quieres durante las primeras horas de un proyecto cuando la API real aún no existe.
Es una herramienta de aprendizaje y prototipado, y es buena en ese trabajo. Cuando necesitas un endpoint del que obtener datos en un tutorial o una demostración rápida, te ahorra tiempo real.
Endpoints, autenticación y límites de DummyJSON
DummyJSON expone varias colecciones de recursos. Las más comunes son:
/products, elementos de catálogo con precio, stock y valoraciones/users, personas con direcciones, correos electrónicos y detalles de la empresa/carts, carritos de compra vinculados a usuarios/postsy/comments, contenido estilo blog/todos, elementos de tareas/recipesy/quotes, conjuntos de contenido adicionales
Cada colección admite los patrones que esperarías de una API REST. Puedes obtener todos los registros, obtener uno por ID, buscar, filtrar por categoría y paginar con limit y skip. Un parámetro select recorta la respuesta a campos específicos, y un parámetro delay (0 a 5000 ms) te permite simular una red lenta para que puedas probar los estados de carga.
Aquí hay una lectura básica:
curl https://dummyjson.com/products?limit=5&skip=10
La autenticación utiliza un endpoint de inicio de sesión y un token de portador. Publicas credenciales en /auth/login, obtienes un token y lo envías en solicitudes protegidas:
# 1. Iniciar sesión para obtener un token
curl -X POST https://dummyjson.com/auth/login \
-H 'Content-Type: application/json' \
-d '{"username":"emilys","password":"emilyspass"}'
# 2. Usar el token en una solicitud autenticada
curl https://dummyjson.com/auth/me \
-H 'Authorization: Bearer YOUR_ACCESS_TOKEN_HERE'
Las escrituras también son compatibles. Puedes enviar solicitudes POST, PUT, PATCH y DELETE, y la API responde como si el cambio hubiera ocurrido. La trampa: esas escrituras son simuladas. DummyJSON devuelve un registro que parece actualizado o creado, pero nada persiste. Actualiza y tu producto "nuevo" habrá desaparecido. Esto es por diseño para un servicio público compartido, y es el límite más importante a entender. La documentación no publica límites de tasa estrictos, pero trata cualquier endpoint gratuito compartido con cuidado y no le dirijas una prueba de carga.
Para un recorrido más completo de lo que hay más allá de DummyJSON, el resumen de APIs gratuitas para desarrolladores cubre opciones en muchas categorías.
DummyJSON vs JSONPlaceholder vs Reqres
DummyJSON no es la única API REST falsa gratuita. Las dos con las que más se compara son JSONPlaceholder y Reqres. Se superponen, pero cada una tiene un enfoque diferente.
| Herramienta | Mejor para | Recursos | Flujo de autenticación | ¿Persisten las escrituras? |
|---|---|---|---|---|
| DummyJSON | Demos realistas estilo e-commerce | Productos, usuarios, carritos, publicaciones, recetas y más | Endpoint de inicio de sesión + token de portador | No (simulado) |
| JSONPlaceholder | Tutoriales CRUD rápidos, configuración mínima | Publicaciones, comentarios, usuarios, tareas, álbumes, fotos | Ninguno | No (simulado) |
| Reqres | Demos de autenticación y flujo de solicitud/respuesta | Usuarios, simulaciones de registro/inicio de sesión | Simulación de registro/inicio de sesión | No (simulado) |
El patrón es el mismo en los tres. Obtienes datos fijos, principalmente de lectura, las escrituras son falsificadas y no puedes cambiar la forma de lo que se devuelve. JSONPlaceholder se ejecuta en json-server internamente, por eso su modelo de datos se siente tan genérico. DummyJSON gana cuando quieres datos que se parezcan a una tienda real. Reqres es útil cuando estás demostrando específicamente una pantalla de inicio de sesión.
Las fuentes oficiales merecen ser marcadas: JSONPlaceholder y el repositorio de GitHub de DummyJSON si quieres auto-alojarlo o leer el código.
Cuando los datos de marcador de posición fijos no son suficientes
Las APIs falsas alojadas encuentran un límite rápidamente una vez que tu proyecto se vuelve específico. Lo notarás cuando:
- Tu aplicación necesite campos que DummyJSON no tenga. Un objeto
subscription_tierofeature_flagssimplemente no está en el esquema, y no puedes añadirlo. - Necesites escrituras que persistan. Construir un flujo de carrito o un panel de administración implica crear un registro y leerlo de nuevo. Las escrituras simuladas rompen ese ciclo.
- Necesites probar rutas de error. Una aplicación real debe manejar un
429, un500o una carga útil mal formada. Las APIs de éxito fijo no producirán esto bajo demanda. - Tus datos deben coincidir con tu propio contrato OpenAPI para que el frontend y el backend estén de acuerdo antes de que se envíe el servidor real.
Este es el punto en el que dejas de tomar prestada la API falsa de otra persona y empiezas a generar la tuya propia. Quieres la misma comodidad de cero-backend, pero con tu esquema, tus nombres de campo y las respuestas que controlas.
Cómo construir tu propia API REST falsa personalizada con Apidog
Apidog es una plataforma de API que diseña, prueba, documenta y simula APIs en un solo lugar. Su servidor de mock es la pieza que reemplaza una API falsa alojada cuando has superado los datos fijos. En lugar de aceptar lo que DummyJSON devuelve, defines el endpoint y la forma de los datos, y Apidog genera respuestas realistas que coinciden. Para seguir los pasos, descarga Apidog y crea un proyecto gratuito.
Aquí está el flujo:
1. Define tu endpoint y esquema. Crea un endpoint como GET /products y describe los campos de respuesta: id, title, price, stock, category. Puedes hacer esto manualmente o importar un archivo OpenAPI/Swagger existente para que la simulación coincida con tu contrato real.
2. Deja que la simulación inteligente genere los datos. Apidog lee tus nombres y tipos de campo, luego produce valores sensatos automáticamente. Un campo llamado email devuelve un correo electrónico, price devuelve un número, createdAt devuelve una fecha. No es necesario escribir datos de prueba manualmente. Si has usado Faker antes, esta es la misma idea integrada en la plataforma. La guía sobre cómo generar datos simulados a partir de esquemas OpenAPI detalla el lado impulsado por el esquema.
3. Personaliza valores y casos extremos. ¿Necesitas un rango específico para price, un enumerado fijo para status o una respuesta 500 deliberada para probar el manejo de errores? Defines reglas por campo y por respuesta. Esta es la parte que las APIs alojadas no pueden hacer, porque tú eres el dueño de la definición.
4. Ejecuta el servidor de mock y llámalo. Apidog te proporciona una URL en vivo. Apunta tu frontend a ella exactamente como lo harías con DummyJSON, excepto que ahora cada campo y código de estado es tuyo:
curl https://<your-mock-host>/products?limit=5
Dado que el mock se genera a partir de tu esquema, cuando tu especificación de API cambia, el mock cambia con ella. Tus datos falsos y tu contrato real nunca se desvían. Si deseas conjuntos de datos más realistas y variados, el enfoque en crear datos de prueba de API realistas se complementa bien con el desarrollo basado en mocks.
La compensación honesta: DummyJSON gana en velocidad para una demostración desechable, ya que no hay nada que configurar. Apidog gana en el momento en que necesitas tu propio esquema, escrituras que persisten, errores controlables o una simulación que se mantenga sincronizada con la API real que vas a lanzar.
Preguntas frecuentes
¿Es DummyJSON de uso gratuito?
Sí. DummyJSON es gratuito y no necesita clave API. Puedes llamar a sus endpoints públicos directamente desde un navegador, curl o tu aplicación. Como cualquier servicio gratuito compartido, está destinado a prototipos y aprendizaje, no a tráfico de producción o pruebas de carga.
¿DummyJSON guarda los datos que creo o actualizo?
No. Las solicitudes POST, PUT, PATCH y DELETE devuelven una respuesta que parece exitosa, pero nada persiste en el servidor. La siguiente lectura devuelve los datos originales. Cuando necesites escrituras que realmente persistan, construye tu propio mock. La guía de APIs mock explica la diferencia entre la simulación y el mocking con estado.
¿Cuál es la diferencia entre DummyJSON y un servidor de mock?
DummyJSON es un conjunto de datos fijo y alojado que todos comparten. Un servidor de mock, como el de Apidog, se ejecuta con tu esquema y devuelve los datos y códigos de estado que defines. Usa DummyJSON para demostraciones genéricas y un servidor de mock cuando los datos deban coincidir con tu propia API.
¿Puedo obtener datos realistas en lugar de marcadores de posición obvios?
Sí, si lo generas a partir de un esquema. Las herramientas basadas en esquemas leen los nombres y tipos de tus campos y producen valores creíbles automáticamente, de modo que un campo email parece un correo electrónico y un price parece un precio. Esa es la razón principal por la que los equipos pasan de una API falsa fija a su propio mock.
Conclusión
DummyJSON es una API REST falsa gratuita y sólida. Es la forma más rápida de renderizar una interfaz de usuario con productos, usuarios y carritos de aspecto realista sin escribir una línea de código backend, y para tutoriales o prototipos rápidos es difícil de superar. Los límites aparecen cuando necesitas tus propios campos, escrituras que persistan, errores controlables o datos que sigan tu contrato de API.
Cuando llegues a ese punto, genera tu propia API REST falsa personalizada en lugar de tomar prestada una fija. Apidog te permite definir el esquema, simular datos realistas a partir de él automáticamente y mantener la simulación sincronizada con la API que lanzarás. Pruébalo gratis y convierte tu especificación en un mock funcional en minutos.