mockapi.dog

Guía de Mock REST API

Crea endpoints REST API gratis e instantáneos con respuestas, códigos de estado y funciones avanzadas personalizadas. Sin registro.

Primeros pasos

Crear un endpoint mock de REST API lleva menos de 30 segundos. Sigue estos sencillos pasos:

  1. 1

    Visita la página principal

    Ve a mockapi.dog y selecciona la pestaña "REST API".

  2. 2

    Define la ruta y el método HTTP

    Escribe la ruta de tu recurso después de la URL generada (por ejemplo, /api/users) y selecciona GET, POST, PUT, PATCH o DELETE.

  3. 3

    Escribe tu respuesta JSON

    Elige un código de estado e introduce el JSON que debe devolver el endpoint. El editor valida el JSON mientras escribes.

    {
  "id": 1,
  "name": "John Doe",
  "email": "john@example.com"
}
  4. 4

    Configura retardos y simulación de errores (opcional)

    Añade un retardo de respuesta, una tasa de error aleatoria o un error activado por una cabecera de la petición.

  5. 5

    Completa la verificación y guarda

    Completa la verificación de Turnstile y pulsa "Guardar endpoint mock". ¡La URL de tu endpoint se copia automáticamente!

    https://abc123.mockapi.dog/api/users

¡Tu endpoint está activo al instante!

Sin despliegue, sin esperas. Empieza a hacer peticiones al momento desde tu app, tus tests o herramientas como Postman y curl.

Funciones principales

Métodos HTTP

Soporte para todos los métodos HTTP estándar para que coincidan con el diseño de tu API.

  • GET - Recuperar datos
  • POST - Crear recursos
  • PUT - Actualización completa
  • PATCH - Actualización parcial
  • DELETE - Eliminar recursos

Códigos de estado

Devuelve cualquier código de estado HTTP para probar éxito, errores y casos límite.

  • 200OK - Éxito
  • 201Creado
  • 400Bad Request
  • 401No autorizado
  • 500Error de servidor

Respuestas JSON

Devuelve cualquier estructura JSON válida: desde objetos simples hasta datos anidados complejos.

  • Objetos y arrays
  • Estructuras anidadas
  • Arrays de objetos
  • Validación en tiempo real
  • Content-Type correcto

Funciones avanzadas

Ajusta tus endpoints mock con potentes funciones para escenarios de prueba realistas.

Retardos de respuesta

Añade un retardo fijo de hasta 10000ms antes de enviar la respuesta para simular redes lentas o tiempos de procesamiento del servidor.

Casos de uso:

  • Probar estados de carga en la UI
  • Simular redes 3G/4G lentas
  • Verificar el manejo de timeouts
  • Comprobar skeleton screens

Ejemplos de retardos:

500ms - Rápido2000ms - Normal5000ms - Lento

Simulación de errores

Configura un porcentaje de peticiones que devolverá errores. Perfecto para probar el manejo de errores y la lógica de reintentos.

Casos de uso:

  • Probar error boundaries
  • Verificar mecanismos de reintentos
  • Comprobar mensajes de error
  • Validar UI de fallback

Ejemplos de tasas de error:

10% errores50% errores100% errores

Cuerpo de la respuesta de error:

{
  "error": "Simulated error (10% error rate)",
  "triggeredBy": "random-error-rate"
}

Errores condicionales

Devuelve un error solo cuando una petición incluye una cabecera con el valor exacto que configures. Envía la cabecera cuando quieras el error y omítela en caso contrario.

Ejemplos de casos de uso:

  • Fallo de autenticación:X-Test-Auth: expired devuelve 401 para probar tu redirección al inicio de sesión
  • No encontrado:X-Test-Error: missing devuelve 404 para probar los estados vacíos
  • Caída del servicio:X-Test-Error: down devuelve 503 para probar tu UI de fallback

Cuando una petición coincide con la cabecera, se devuelve el error de la cabecera en lugar de aplicar la tasa de error aleatoria.

Cuerpo de la respuesta de error:

{
  "error": "Conditional error triggered by header X-Test-Error: down",
  "triggeredBy": "conditional-header-match"
}

TTL (tiempo de vida)

Los endpoints pertenecen a un código, el subdominio de 6 caracteres de tu URL. Cuando el código expira, se elimina junto con todos sus endpoints. Los códigos nuevos expiran al cabo de 1 mes. Después de guardar un endpoint, cambia la expiración con el botón del reloj junto a la URL.

Opciones disponibles:

1 semana1 mes (predeterminado)3 mesesPersonalizado (1-365 días)

Perfecto para pruebas o demos temporales. Sin necesidad de limpiar manualmente.

Request Inspector

Observa las peticiones que reciben tus endpoints a medida que llegan. Activa el interruptor "Logging" en el panel "Request Inspector", debajo de tus endpoints guardados.

  • Las últimas 50 peticiones del código, de la más reciente a la más antigua
  • Método, ruta, código de estado y tiempo de respuesta
  • Cabeceras, parámetros de consulta y cuerpo de la petición (los cuerpos de más de 10KB se truncan)
  • Las cabeceras de autorización y cookies se muestran como [redacted]

El registro de peticiones está desactivado por defecto y abarca todos los endpoints del código. Solo se capturan las peticiones que coinciden con un endpoint guardado, y se conservan durante 7 días desde la más reciente. Pausa la vista en tiempo real o vacía la lista cuando quieras.

Tareas comunes

Crear un endpoint

  1. Abre mockapi.dog en la pestaña "REST API (JSON)"
  2. Añade una ruta a la URL y selecciona un método HTTP
  3. Introduce tu respuesta JSON
  4. Configura los ajustes opcionales
  5. Completa la verificación y pulsa "Guardar endpoint mock"

✓ ¡Tu endpoint ya está activo!

Editar un endpoint

  1. Encuentra tu endpoint en la lista "Endpoints guardados"
  2. Pulsa el botón del lápiz ("Editar")
  3. Cambia el método, la respuesta, el estado o los ajustes (la URL queda bloqueada durante la edición)
  4. Pulsa "Actualizar endpoint"

✓ Los cambios se aplican al instante

Eliminar un endpoint

  1. Localiza el endpoint que quieres eliminar
  2. Pulsa el botón de la papelera ("Eliminar")
  3. El endpoint se elimina al momento, sin pedir confirmación

Esta acción no se puede deshacer

Probar un endpoint

Con curl:

curl https://abc123.mockapi.dog/api/users

Con JavaScript:

fetch('https://abc123.mockapi.dog/api/users')

Resolución de problemas

El endpoint devuelve 404 Not Found

Solution: Revisa la URL, el método HTTP y la ruta: los tres deben coincidir con lo que guardaste. Si coinciden, puede que el código haya expirado y se haya eliminado junto con sus endpoints.

Error de JSON no válido al crear el endpoint

Solution: Valida tu JSON con el editor integrado. Errores típicos: comas que faltan, claves sin comillas, comas finales o comillas sin escapar.

Errores de CORS en el navegador

Solution: Todos los endpoints incluyen automáticamente cabeceras CORS. Si sigues viendo errores, comprueba que estás usando la URL y el método HTTP correctos.

El endpoint es demasiado lento

Solution: Comprueba si has añadido un retardo de respuesta en los ajustes avanzados. Elimina o reduce el valor del retardo si no lo necesitas.

Las peticiones devuelven 429 Too Many Requests

Solution: Cada endpoint tiene un límite diario de llamadas. Al alcanzarlo, las llamadas devuelven 429 con el límite y una hora resetAt (medianoche, hora del servidor) en el cuerpo. Además, cada dirección IP está limitada a 100 peticiones por minuto en todo el servicio.

El Request Inspector no muestra peticiones

Solution: El registro está desactivado por defecto. Activa el interruptor "Logging" en el panel "Request Inspector" y vuelve a llamar al endpoint. No se capturan las peticiones a rutas sin un endpoint guardado.

Consejos y buenas prácticas

Usa datos realistas

Incluye nombres de campo, tipos de datos y estructuras realistas que coincidan con tu API real. Así las pruebas tienen más valor.

Prueba casos límite

Crea endpoints para arrays vacíos, valores null y escenarios de error. Esto ayuda a detectar bugs cuanto antes.

Documenta tus endpoints

Mantén una lista de tus endpoints y para qué sirven. Comparte URLs con tu equipo para colaborar.

Usa los retardos con cabeza

Añade pequeños retardos para probar estados de carga. Usa retardos más largos para verificar el manejo de timeouts.

Versiona tus respuestas

Crea varios endpoints para distintas versiones de la API. Así pruebas la compatibilidad hacia atrás.

Limpia los endpoints que no usas

Elimina periódicamente los endpoints que ya no necesites. Usa el TTL para que los temporales expiren automáticamente.

Biblioteca de Mock API lista para usar

Ofrecemos mock APIs precargadas para casos de uso comunes. Pulsa cualquier categoría para explorar endpoints listos para usar que puedes probar al momento, sin configuración.

API de Users

Perfiles de usuario, roles, permisos y gestión de cuentas

API de Posts

Posts y artículos de blog con patrones de gestión de contenido

API de Todos

Ejemplo CRUD clásico con estado, filtros y paginación

API de Auth

Login, logout, refresh tokens y registro de usuarios

API de Products

Productos de e-commerce con precio, disponibilidad y metadatos

API de Orders

Gestión de pedidos con flujos de estado y asociación con usuarios

API de Cart

Carrito de la compra con gestión de ítems y manejo de relaciones

API de Payments

Procesamiento de pagos con operaciones asíncronas y webhooks

Consejo: explora la biblioteca completa

Visita nuestra Biblioteca de Mock API para explorar todos los endpoints precargados con ejemplos en vivo, respuestas de muestra y pruebas con un solo clic.

Glosario

REST API

Representational State Transfer API: un estilo arquitectónico para construir servicios web usando métodos HTTP estándar.

Métodos HTTP

Métodos de petición estándar (GET, POST, PUT, PATCH, DELETE) que indican la acción deseada sobre un recurso.

Código de estado

Código de tres dígitos que devuelve el servidor para indicar el resultado de una petición (200 OK, 404 Not Found, 500 Error, etc.).

JSON

JavaScript Object Notation: un formato de datos ligero para estructurar e intercambiar datos entre cliente y servidor.

Endpoint

Una URL concreta donde se puede acceder a una API. Cada endpoint cumple una función específica.

Mock API

Una API simulada que devuelve respuestas predefinidas, usada para pruebas y desarrollo sin un backend real.

CORS

Cross-Origin Resource Sharing: una funcionalidad de seguridad que controla qué dominios pueden acceder a tu API desde el navegador.

TTL

Time To Live: cuánto tiempo existen un código y todos sus endpoints antes de eliminarse automáticamente.

Tasa de error

Porcentaje de peticiones que deberían devolver errores. Se usa para probar el manejo de errores y la lógica de reintentos.

Retardo de respuesta

Tiempo de espera artificial añadido antes de enviar una respuesta. Simula redes lentas o procesamiento.

Código

El subdominio único de 6 caracteres de tu mock API (abc123 en abc123.mockapi.dog). Los endpoints, la expiración y el registro de peticiones pertenecen a un código.

Request Inspector

Un registro en tiempo real de las peticiones que reciben los endpoints de un código, con cabeceras, parámetros de consulta y cuerpo.

¿Listo para crear tu primera REST API?

Empieza a crear endpoints REST API mock gratis en segundos. Sin registro, sin tarjeta de crédito. Perfecto para pruebas, prototipado y desarrollo.

Crear endpoint REST ahora →← Volver a la documentación