Cómo modificar respuestas HTTP con Map Local de Proxyman
Este breve artículo técnico mostrará qué es la herramienta Map Local y cómo nos puede ayudar a modificar rápidamente la respuesta.
Esperamos que Proxyman te ayude a mejorar tu productividad al depurar 👏.
1. La herramienta Map Local
La herramienta Map Local te permite usar el contenido de archivos locales como respuesta a tus solicitudes, siempre que coincidan con tus reglas.
La herramienta Map Local puede acelerar notablemente el desarrollo y permite probar rápidamente varios casos límite sin tener que actualizar explícitamente los datos de tu servidor. También es una herramienta imprescindible para QA y desarrolladores que quieran comprobar el comportamiento de la app con distintas respuestas.
2. Beneficios de modificar la respuesta HTTP
Durante la depuración hay muchos escenarios en los que probarías distintos tipos de respuesta para verificar el diseño o el contenido en tus dispositivos y apps:
- Probar rápidamente nuevos parámetros en las respuestas.
- Comprobar el comportamiento de la app con distintos parámetros en las respuestas.
- Probar el diseño de la UI con contenidos inusuales.
- Probar la localización.
- Reproducir rápidamente el bug con parámetros específicos en las respuestas.
3. Cómo funciona
-
Si la URL de las solicitudes entrantes coincide con una regla de coincidencia predefinida y el archivo local es válido, el body de la respuesta de esas solicitudes se reemplaza automáticamente por el contenido del archivo local.
-
Si las solicitudes no coinciden con ninguna regla, todo el contenido de la respuesta se mantiene tal como lo envía el servidor.
4. Regla de coincidencia
Puedes definir la regla de forma sencilla combinando los comodines (wildcards) y la opción Include subdirectories.
-
Coincidencia de arriba hacia abajo (Top-Down Matching): las solicitudes entrantes se evalúan por prioridad de arriba hacia abajo. La regla que está en la parte superior de la lista es la primera que se evalúa.
-
Asterisco ( * ): coincide con cualquier carácter cero o más veces. Por ejemplo, "api.proxyman.com/v1/*" coincide con cualquier URL que empiece por "api.proxyman.com/v1/", como "api.proxyman.com/v1/login", "api.proxyman.com/v1/data" y "api.proxyman.com/v1/", ...
-
Signo de interrogación ( ? ): coincide con un solo carácter una vez. Por ejemplo, "api.proxyman.com/v?/login" coincide con api.proxyman.com/v1/login y api.proxyman.com/v2/login
-
Include subdirectories: todos los subdirectorios coincidirán automáticamente. Es muy práctico si quieres que coincidan todas las rutas del dominio. Por ejemplo: "api.proxyman.com" con ON en "Include subdirectories" coincide con todas las URL que tienen "api.proxyman.com" como dominio, como "api.proxyman.com", "api.proxyman.com/v1/data", "api.proxyman.com/login", "api.proxyman.com/user?name=nghia", ...
-
HTTP / HTTPS include: por defecto, "api.proxyman.com" coincide con todas las solicitudes que usen HTTP o HTTPS como esquema. En cambio, "http://api.proxyman.com" solo coincide con HTTP, y "https://api.proxyman.com" solo coincide con HTTPS.
6. Funciones adicionales
La herramienta Map Local también ofrece varias formas de gestionar rápidamente la lista de reglas y admite atajos de teclado.
- ⌘ + ⌥ + L: abre rápidamente la ventana de Map Local.
- ⌘ + N: nueva entrada
- ⌘ + E: editar entrada
- ⌘ + D: duplicar entrada
- ⌘ + ⌫: eliminar entrada
- Admite la selección múltiple de entradas
- Abre rápidamente el archivo local en el Finder o en tu editor favorito.
- Todos los cambios se aplican de inmediato y no necesitas guardar.
- En las respuestas que coinciden, el "Content-Type" se reemplaza automáticamente por el tipo del archivo local. Por ejemplo: application/json, image/png, image/jpg, .... Así, la app gestionará la respuesta de forma adecuada.
7. Cómo usarla
Hay varias formas de acceder a la herramienta Map Local. Si la abrimos desde Domains o desde los flujos, la regla de coincidencia se rellenará automáticamente.
Consejo útil
Coloca la regla más específica por encima de una regla general para que se evalúe primero. En una API con muchas rutas coincidentes, Map Local también puede usar un directorio local en lugar de un archivo cada vez. Asegúrate de que el archivo mock sea válido para su tipo de contenido y, antes de terminar, prueba una respuesta normal, una respuesta vacía y una respuesta de error.
Proxyman es una app de alto rendimiento para macOS que permite a los desarrolladores capturar e inspeccionar solicitudes HTTP/HTTPS de apps y dominios en dispositivos iOS, en el simulador de iOS y en dispositivos Android.
Descárgala en https://proxyman.com
