¿Qué es Decoy?

Decoy es una potente e intuitiva aplicación nativa de macOS diseñada para desarrolladores que necesitan crear y gestionar servidores mock locales con facilidad. Simplifica el proceso de simulación de endpoints de API, pruebas de integraciones de webhooks y depuración de código relacionado con la red al proporcionar un entorno sencillo que no requiere configuración. A diferencia de los métodos tradicionales que a menudo implican configuraciones complejas, contenedores Docker o servicios de túnel basados en la nube, Decoy ofrece una experiencia de encendido instantáneo directamente en tu Mac.

Construido con tecnologías modernas de macOS como SwiftUI y Network.framework, Decoy está optimizado para el rendimiento y la eficiencia de los recursos. Se inicia instantáneamente, consume una memoria mínima y permite cambios en tiempo real en las respuestas mock, asegurando un flujo de trabajo de desarrollo sin interrupciones. Ya sea que estés creando una nueva aplicación, integrando con servicios de terceros o probando casos extremos como fallos de red y tiempos de espera, Decoy proporciona la flexibilidad y el control que necesitas para acelerar tu ciclo de desarrollo.

Creación de Servidores Mock para Desarrolladores

• Creación Sencilla de Servidores Mock: Define endpoints con métodos personalizados, rutas y agrúpalos en proyectos para una mejor organización.
• Monitorización de Solicitudes en Tiempo Real: Visualiza todas las solicitudes entrantes con información detallada, incluyendo encabezados, cuerpo, IP de origen y marcas de tiempo. Las cargas útiles JSON se formatean automáticamente para facilitar la lectura.
• Mocking Flexible de Respuestas: Configura respuestas con cualquier código de estado HTTP, elige entre 7 tipos de cuerpo diferentes (texto plano, JSON, HTML, XML, archivo, vacío, redirección), establece encabezados personalizados y simula latencia.
• Rutas Parametrizadas: Soporte para rutas dinámicas como /users/:id para que coincidan con varios parámetros de solicitud.
• Múltiples Tipos de Cuerpo de Respuesta: Sirve fácilmente JSON, HTML, XML, texto plano, archivos (imágenes, PDFs), respuestas vacías o realiza redirecciones.
• Cambios Instantáneos: Las modificaciones en endpoints o respuestas surten efecto inmediatamente en la siguiente solicitud entrante.
• Exportación de Solicitudes: Copia los detalles de la solicitud como fragmentos de código cURL, JavaScript fetch o Ruby para facilitar la depuración y el intercambio.
• Manejo Automático de CORS: Los encabezados CORS se añaden automáticamente, asegurando que las solicitudes basadas en navegador funcionen sin problemas.
• Respuestas de Archivo: Sirve archivos estáticos directamente como respuestas.
• Experiencia Nativa de macOS: Construido con SwiftUI para una aplicación rápida, receptiva y eficiente en memoria. No requiere Docker, túneles en la nube ni archivos de configuración complejos.
• Agrupación de Proyectos: Organiza endpoints bajo subdominios personalizados (por ejemplo, api.decoy.my).
• Instantáneas de Respuesta: Revisa las respuestas exactas que se enviaron para cada solicitud.
• Dominios Personalizados: Utiliza dominios predeterminados como decoy.my o lvh.me, o configura los tuyos propios.
• Inspección Detallada de Solicitudes: Examina encabezados, cuerpo (con volcado hexadecimal para datos binarios), IP de origen, marcas de tiempo y un UUID único para cada solicitud.
• Soporte de Redirección: Configura fácilmente redirecciones 301, 302, 307 y 308 con manejo automático del encabezado Location.
• Almacenamiento Persistente: Las solicitudes se guardan en una base de datos SQLite, asegurando que no haya pérdida de datos incluso si la aplicación se cierra inesperadamente.

Cómo Usar Decoy

Comenzar con Decoy está diseñado para ser sencillo:

1. Instala Decoy: Descarga e instala Decoy desde la Mac App Store.
2. Crea un Proyecto: Inicia Decoy y crea un nuevo proyecto. Puedes asignar un subdominio personalizado (por ejemplo, miapi) o usar el dominio predeterminado decoy.my.
3. Define Endpoints: Añade nuevos endpoints dentro de tu proyecto. Especifica el método HTTP (GET, POST, PUT, DELETE, etc.) y la ruta (por ejemplo, /usuarios, /productos/:id).
4. Configura Respuestas: Para cada endpoint, define la respuesta deseada. Elige el código de estado, selecciona el tipo de cuerpo (JSON, texto, archivo, etc.), añade los encabezados necesarios y, opcionalmente, establece un retraso para simular la latencia de la red.
5. Apunta tu Aplicación: Configura tu aplicación, script o servicio para enviar solicitudes a la dirección proporcionada por Decoy (por ejemplo, http://miapi.decoy.my:8998).
6. Monitoriza y Depura: A medida que llegan las solicitudes, Decoy las mostrará en tiempo real. Puedes inspeccionar todos los detalles de la solicitud entrante y verificar la respuesta que se envió.
7. Itera: Realiza cambios en tus configuraciones de endpoints o respuestas sobre la marcha. Decoy aplica estos cambios instantáneamente, permitiendo una rápida iteración y depuración.

Casos de Uso

• Desarrollo y Pruebas de API: Simula respuestas de API de backend durante el desarrollo frontend, permitiendo a los equipos trabajar en paralelo sin esperar la finalización del backend. Prueba varios escenarios de respuesta, incluyendo códigos de error y casos extremos.
• Pruebas de Integración de Webhooks: Prueba fácilmente cómo tu aplicación maneja los webhooks entrantes de servicios de terceros como Stripe, GitHub o Slack configurando Decoy para recibir e inspeccionar estas cargas útiles localmente.
• Desarrollo de Aplicaciones Móviles: Mock de solicitudes de red para aplicaciones móviles para probar el comportamiento de la UI, escenarios sin conexión y manejo de errores sin depender de un backend en vivo.
• Pruebas de Resiliencia de Red: Simula condiciones de red lentas o tiempos de espera introduciendo retrasos en las respuestas de Decoy, ayudando a construir aplicaciones más robustas que manejan la latencia con gracia.
• Desarrollo de Scrapers y Bots: Prueba scrapers o bots que interactúan con servicios web proporcionando respuestas predecibles desde un servidor mock local.

Preguntas Frecuentes

• ¿Cuáles son los requisitos del sistema para Decoy? Decoy requiere macOS 14 Sonoma o posterior.

• ¿Es Decoy gratuito? Decoy es una aplicación de pago disponible para su compra en la Mac App Store por 24,99 €.

• ¿Necesito Docker o Node.js para usar Decoy? No, Decoy es una aplicación nativa de macOS autocontenida. No requiere Docker, Node.js ni ningún otro entorno de ejecución externo para su funcionalidad principal.

• ¿Puede Decoy manejar solicitudes HTTPS? Actualmente, Decoy se centra en solicitudes HTTP. Para mocking HTTPS, normalmente necesitarías configurar un proxy inverso o utilizar un conjunto de herramientas diferente.

• ¿Cómo se almacenan las solicitudes? Las solicitudes entrantes se guardan en una base de datos SQLite local, lo que garantiza que el historial de tus solicitudes se conserve incluso si la aplicación se cierra inesperadamente.