# Map Local (archivo)

> Usa Proxyman Map Local para devolver un archivo local como respuesta a una solicitud, con tu propio código de estado, encabezados y cuerpo, y simular APIs rápidamente.

## 1. ¿Qué es? {#1-whats-it}

La herramienta Map Local te permite usar el contenido de un archivo local como respuesta HTTP a tus solicitudes.

> **Nota:** Puedes usar Map Local para **GraphQL** con la herramienta Scripting ([Snippet Code](https://proxyman.com/docs/es/scripting/snippet-code#map-local-with-graphql))
>
> Puedes combinar **Map Local con Breakpoint** para modificar el contenido sobre la marcha (2.16.0+)

## Video {#video}

[Video: Simula respuestas de API con Map Local](https://proxyman.com/videos/map-local) (25 seconds)

## 2. Beneficios {#2-benefits}

* Define una respuesta con Status Code, Headers y Body, y asígnala a una solicitud concreta. Puedes probar casos límite sin esperar a una actualización del servidor.
* **Simula una API falsa con un archivo local**: prueba APIs de prueba que todavía no están en producción. 

![Editor de Map Local de Proxyman para GET https://httpbin.proxyman.app/get en el modo Local File, con una respuesta JSON 200 OK](https://proxyman.com/docs/assets/proxyman-map-local-editor.jpg)

_Editor de Map Local_

### Con un mensaje HTTP {#with-an-http-message}

1. Haz clic con el botón derecho en tu solicitud de la tabla principal -> **Tools** -> **Map Local…**. Proxyman crea una nueva regla con la respuesta actual.
2. Cambia el Status Code, los Headers y el JSON Body como quieras.
3. Listo.
4. Vuelve a enviar tu solicitud. La nueva respuesta queda mapeada.

### Con un archivo local {#with-a-local-file}

* Haz clic en el botón **Select Local File** y selecciona cualquier archivo. Admite archivos de texto, JSON, binarios e imágenes.

### Con el flag \<FILE\_URL> {#with-file_url-flag}

* Mapea a un archivo concreto y, aun así, define el Status Code y los Response Headers.
* Funciona con JSON, texto, binarios, imágenes, etc.
* Asegúrate de definir el encabezado `Content-Type` para que tu cliente pueda leer bien la respuesta.

```json
HTTP/1.1 200 OK
Content-Type: application/json

<FILE_URL="~/Desktop/myjson.json">
```

## 3. Cómo usarlo {#3-how-to-use}

1. Haz clic con el botón derecho en la solicitud (que ya tiene una respuesta) -> **Tools** -> **Map Local…**. Proxyman crea una regla con el cuerpo de la respuesta actual y guarda el archivo en su propia carpeta de Map Local. Para ver o cambiar esta carpeta, haz clic en **More** en la ventana de Map Local -> **Default Local File Folder**.
2. Cambia el cuerpo de la respuesta directamente en el editor.
3. Haz una solicitud y comprueba el nuevo cuerpo de la respuesta.

![Crear una regla de Map Local con la respuesta actual](https://proxyman.com/docs/assets/proxyman-map-local-context-menu.jpg)

_Crear una regla de Map Local con la respuesta actual_

![Menú More de Map Local en Proxyman con Default Local File Folder abierto: Choose Folder, Use Default Folder, Reveal in Finder](https://proxyman.com/docs/assets/proxyman-map-local-default-folder.jpg)

_Carpeta de archivos locales predeterminada_

## 4. Map Local con solicitudes GraphQL {#4-map-local-with-graphql-requests}

Desde Proxyman 2.27.0+, Map Local puede trabajar con solicitudes GraphQL mediante un QueryName concreto. Consulta el siguiente documento sobre GraphQL.

- [GraphQL](https://proxyman.com/docs/es/advanced-features/graphql)

## 5. Map Local con la herramienta Scripting ✅  {#5-map-local-with-scripting-tool--}

Si quieres usar Map Local con **reglas complejas**, consulta [Scripting](https://proxyman.com/docs/es/scripting/script#1-whats-it), ya que es más fácil obtener el mismo resultado.

Consulta este [Snippet Code](https://proxyman.com/docs/es/scripting/snippet-code#2-common-on-request-and-response) para ver cómo mapear un archivo local con código JavaScript.

## Más información {#learn-more}

* [Cómo manipular la respuesta HTTP con la herramienta Map Local de Proxyman](https://proxyman.com/posts/2019-08-03-map-local-feature)
* [¿Cómo mapear una respuesta local para solicitudes GraphQL?](https://proxyman.com/posts/2021-01-24-How-To-Map_Response_For_GraphQL_Requests)
