Cómo probar con una API ficticia (y construir tu propia API falsa cuando la necesites)

Cuando estás construyendo un frontend, depurando un cliente o aprendiendo una nueva librería HTTP, a menudo necesitas un endpoint que devuelva JSON de aspecto real sin tener que levantar un backend. Una API ficticia te da exactamente eso: un servicio público, gratuito y siempre activo que puedes llamar ahora mismo. Esta guía enumera las mejores APIs ficticias públicas, te muestra cómo llamarlas y explica cuándo dejar de tomar prestados datos de otros y construir tu propia API REST falsa. Si quieres una introducción más profunda al panorama de las APIs públicas, la guía de MDN para usar la Fetch API complementa bien todo lo que se expone a continuación.

botón

Qué es realmente una API ficticia

Una API ficticia es un servicio alojado que devuelve JSON predefinido y realista para tipos de recursos comunes: usuarios, publicaciones, productos, carritos, tareas. No te registras, no alojas nada y no te preocupas por romper los datos de producción. La mayoría acepta GET, POST, PUT, PATCH y DELETE, pero las operaciones de escritura suelen ser simuladas. El servidor devuelve tu carga útil con un ID y simula que la guardó, mientras que nada se mantiene realmente.

Esa es la característica clave que debes comprender antes de confiar en una. Una API ficticia es perfecta para prototipos con muchas lecturas y para demostrar que tu código de solicitud funciona. Es inadecuada en el momento en que necesitas un comportamiento con estado, tus propias formas de datos o condiciones de error personalizadas.

Las mejores APIs ficticias y falsas gratuitas para probar

Aquí tienes las APIs públicas que vale la pena conocer. Todas son gratuitas y no requieren configuración de backend de tu parte.

JSONPlaceholder

JSONPlaceholder es el clásico. Sirve seis recursos relacionados: 100 publicaciones, 500 comentarios, 100 álbumes, 5,000 fotos, 200 tareas y 10 usuarios. Las relaciones son reales, por lo que una publicación tiene comentarios y un álbum tiene fotos, lo que lo hace bueno para probar recuperaciones anidadas.

curl https://jsonplaceholder.typicode.com/posts/1

Obtienes un único objeto de publicación. Las solicitudes de escritura se aceptan pero no se guardan, por lo que un POST /posts devuelve un id: 101 falso cada vez.

DummyJSON

DummyJSON es más amplio. Ofrece productos, carritos, usuarios, publicaciones, comentarios, citas, tareas y recetas, además de un flujo de autenticación que te entrega un token. Si estás probando una interfaz de usuario de carrito de compras o una pantalla de inicio de sesión, esta es la que debes usar.

curl https://dummyjson.com/products/1

El endpoint de autenticación te permite hacer POST con un nombre de usuario y contraseña y recibir un JWT, lo cual es útil para practicar el almacenamiento de tokens y las solicitudes autenticadas sin configurar un proveedor de identidad real.

reqres.in

reqres.in se centra en el ciclo de vida de la solicitud y respuesta: listar usuarios, un solo usuario, registrar, iniciar sesión, respuestas con retraso. Está diseñado para demostrar paginación y flujos de autenticación. Una cosa a saber: el nivel gratuito ahora espera un encabezado de clave API. Envía x-api-key: reqres-free-v1 con tus solicitudes, o recibirás un 401.

curl https://reqres.in/api/users/2 -H "x-api-key: reqres-free-v1"

Dónde encaja cada una

API Ficticia	Mejor para	Flujo de autenticación	Persistencia de escritura
JSONPlaceholder	Lecturas anidadas, datos estilo blog	No	Simulada, no guardada
DummyJSON	Comercio electrónico, carritos, inicio de sesión	Sí (token)	Simulada, no guardada
reqres.in	Paginación, demostraciones de registro/inicio de sesión	Encabezado de clave API	Simulada, no guardada

Si quieres un catálogo más amplio de opciones más allá de estas tres, el resumen de APIs públicas para pruebas cubre opciones más especializadas, y la lista de APIs públicas gratuitas para desarrolladores es útil cuando necesitas datos temáticos como el clima o la moneda.

Cómo llamar a una API ficticia en tu código

Llamar a una es lo mismo que llamar a cualquier endpoint HTTP. Aquí hay un ejemplo simple de fetch en JavaScript que lee un usuario y luego publica uno nuevo.

// Leer
const res = await fetch('https://dummyjson.com/users/1');
const user = await res.json();
console.log(user.firstName);

// Escribir (devuelto, no persistido)
const created = await fetch('https://dummyjson.com/users/add', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ firstName: 'Ada', lastName: 'Lovelace' }),
});
console.log(await created.json()); // devuelve un objeto con un id falso

En Python con requests, la forma es igual de corta.

import requests

r = requests.get("https://jsonplaceholder.typicode.com/todos/1")
print(r.json())

Coloca cualquiera de estos en un archivo de prueba y tendrás una integración funcional para afirmar. Si necesitas valores creíbles para esas aserciones, la guía sobre crear datos de prueba de API realistas muestra cómo generar nombres, correos electrónicos y marcas de tiempo que parecen tráfico de producción en lugar de test123.

Cuando una API ficticia pública deja de ser suficiente

Las APIs ficticias públicas son geniales hasta que tus necesidades se vuelven específicas. Te toparás con un muro en algunas situaciones comunes:

Tus formas de datos no coinciden. Tu aplicación espera un campo subscription_tier y un objeto billing anidado. JSONPlaceholder te da posts y albums. No puedes adaptar su esquema al tuyo.
Necesitas estado. Un carrito real se actualiza cuando añades un artículo. Las APIs ficticias olvidan tu POST en el momento en que lo devuelven.
Necesitas fallos controlados. Probar cómo tu UI maneja un 429, un 200 lento o un cuerpo malformado es difícil cuando el servicio público siempre se comporta bien.
Estás construyendo antes de que exista el backend. Los equipos de frontend y backend a menudo empiezan al mismo tiempo. Necesitas endpoints que coincidan con el contrato acordado hoy, no cuando se lance la API.

En ese momento, no necesitas una API prestada. Necesitas tu propia API falsa que devuelva tus formas, bajo demanda, con las respuestas que controlas. Eso es una API mock construida para pruebas, y ahí es donde encaja Apidog.

Cómo construir tu propia API falsa con Apidog

Apidog es una plataforma de API que combina diseño, pruebas, depuración y mocking en un solo lugar. Su mocking está basado en esquemas, por lo que lee la estructura de tu endpoint y genera datos falsos realistas automáticamente utilizando reglas Faker integradas. Defines la forma una vez, y cada solicitud devuelve valores frescos y plausibles.

Aquí está la versión corta del flujo de trabajo.

Crea o importa un endpoint. Define una nueva API en Apidog, o importa un archivo OpenAPI o Swagger existente. Apidog lee el esquema directamente.
Deja que el mock inteligente rellene los datos. Para un campo llamado email, Apidog devuelve un correo electrónico. Para createdAt, devuelve una marca de tiempo. Para price, un número. Puedes ajustar estas reglas por campo, para que un campo country devuelva nombres de países reales en lugar de cadenas aleatorias.
Accede a la URL del mock local. Apidog activa un servidor mock y te da una URL para cada endpoint. Lláma desde tu frontend, tus pruebas o curl, exactamente como una API ficticia pública, excepto que las respuestas coinciden con tu contrato.
Añade respuestas condicionales y de error. Configura un mock para que devuelva un 500, un 404 o una respuesta con retraso según la solicitud. Ahora puedes probar las rutas de error que los servicios públicos nunca te permiten reproducir.

Debido a que el mock se genera a partir de tu especificación, se mantiene sincronizado a medida que tu diseño evoluciona. Cambia un campo y el mock lo refleja. Si quieres una visión más amplia de cómo generar mocks directamente desde una especificación, el tutorial sobre generación de datos mock a partir de esquemas OpenAPI profundiza en el aspecto Faker.

API ficticia pública vs. tu propio mock de Apidog

Necesidad	API ficticia pública	Mock de Apidog
Datos rápidos de solo lectura	Excelente	Excelente
Tus formas de datos exactas	No	Sí
Respuestas de error y retraso personalizadas	No	Sí
Coincide con tu contrato OpenAPI	No	Sí
Tiempo de configuración	Cero	Minutos

Ninguno es estrictamente mejor. Una API ficticia pública gana cuando solo necesitas cualquier JSON en cinco segundos. Tu propio mock de Apidog gana en el momento en que la corrección contra tu contrato real importa. La mayoría de los equipos usan ambos: los públicos para experimentos desechables, un mock de proyecto para todo lo que se lanza.

Preguntas frecuentes

¿Es una API ficticia lo mismo que una API mock?

Se superponen pero no son idénticas. Una API ficticia generalmente significa un servicio público compartido con datos de muestra fijos, como JSONPlaceholder. Una API mock es una que tú defines y controlas, que devuelve tus propias formas y comportamientos. Una API ficticia es un tipo de mock que alguien más ya aloja. Si quieres la distinción detallada, consulta la explicación sobre qué es una API mock.

¿Las APIs falsas gratuitas son seguras de usar con datos reales?

No. Nunca envíes datos de usuario reales, secretos o tokens a una API ficticia pública. Considera que todo lo que POSTees se registra y es visible. Úsalas solo con valores de prueba desechables. Cuando necesites privacidad o persistencia, aloja tu propio mock en su lugar.

¿Las APIs ficticias guardan los datos que envío?

Casi nunca. JSONPlaceholder, DummyJSON y reqres.in aceptan solicitudes de escritura y devuelven un resultado con un ID generado, pero nada persiste. Actualiza y tu registro "creado" habrá desaparecido. Si necesitas un estado que se mantenga, necesitas un mock con estado o un backend real.

¿Puedo construir una API falsa sin escribir código?

Sí. Con Apidog, defines la forma del endpoint y dejas que el mocking inteligente genere los datos, sin necesidad de código de servidor. También puedes importar un archivo OpenAPI y obtener endpoints mock funcionales en minutos.

Conclusión

Las APIs ficticias públicas como JSONPlaceholder, DummyJSON y reqres.in son la forma más rápida de obtener JSON realista para prototipos y aprendizaje. No cuestan nada y no necesitan configuración. En el momento en que necesites tus propias formas de datos, estado real o respuestas de error controladas, construye una API falsa que realmente te pertenezca.

Apidog te permite hacer exactamente eso: importa tu especificación, obtén datos mock basados en esquemas y llama a tus propios endpoints en minutos. Descarga Apidog y convierte tu próximo contrato de API en un mock funcional antes de que exista una línea de código backend. Descubre cómo se adapta a tu flujo de trabajo de pruebas en Apidog.