EcholotCarpetas
Organiza las solicitudes en carpetas, muévelas y reordénalas, actúa sobre varias a la vez y define la autenticación, las variables y los scripts que heredan todas las solicitudes de dentro.
Las carpetas agrupan las solicitudes en el árbol de solicitudes de la barra lateral, y llevan ajustes: la
autenticación, las variables y los scripts que defines en una carpeta se aplican a todas las solicitudes de dentro. En
el disco, una carpeta es un directorio dentro de requests/ con un _folder.toml.
Crea una carpeta
- Archivo › Nueva carpeta (⇧⌘N), mientras la barra lateral muestra Solicitudes.
- El + junto a Solicitudes en la barra lateral y luego Nueva carpeta.
- Haz Control-clic en una carpeta y elige Nueva carpeta para crear una dentro de ella, o haz Control-clic en un espacio vacío del árbol para crear una en el nivel superior.
El nombre de la carpeta nueva queda listo para editarse. Escribe un nombre y pulsa ↩.
Nueva solicitud en el menú contextual de una carpeta pone la solicitud dentro de ella. Archivo › Nueva solicitud (⌘N) y los demás comandos Nueva solicitud … la ponen donde estás en el árbol.
Renombra, duplica y reordena
Haz Control-clic en una solicitud o carpeta para ver su menú:
| Comando | Qué hace |
|---|---|
| Ejecutar solicitud / Ejecutar carpeta | La ejecuta en la página Ejecución, con sus comprobaciones. |
| Renombrar | Edita el nombre en el sitio. ↩ sobre una fila seleccionada hace lo mismo; Esc lo deja. |
| Duplicar | Copia una solicitud (⌘D). |
| Subir, Bajar | Mueve el elemento un lugar dentro de su carpeta. |
| Mostrar en el Finder | Muestra el archivo o la carpeta del elemento. |
| Trasladar a la papelera… | Pregunta y luego lo traslada a la papelera. |
Las carpetas también tienen Nueva solicitud, Nueva carpeta, Ajustes de la carpeta…, Vincular a una especificación OpenAPI… (o Buscar cambios en la especificación OpenAPI… una vez vinculada; consulta las especificaciones), Documentar en la especificación OpenAPI… (consulta las especificaciones a partir del tráfico) y Exportar carpeta… (consulta exportar).
El orden que das a los elementos se guarda en el _folder.toml de la carpeta, así que es el mismo para todo el que abre
el espacio de trabajo.
Mueve elementos con el teclado y el ratón
En el árbol de solicitudes, ↑ y ↓ mueven la selección, → abre una carpeta y ← la cierra o va a la carpeta de arriba.
Arrastra solicitudes y carpetas para moverlas:
- Se abre un hueco donde caerá el elemento, y las filas de debajo le hacen sitio.
- Debajo de una carpeta abierta, mueve el puntero a izquierda o derecha para elegir la profundidad: dentro de la carpeta o después de ella.
- Detente un momento sobre una carpeta cerrada y se abre, para que puedas soltar entre sus elementos. Las carpetas abiertas así se vuelven a cerrar cuando el arrastre termina en otro sitio.
- Al arrastrar uno de varios elementos seleccionados, se mueven todos.
Suelta archivos del Finder sobre el árbol para importarlos en esa carpeta: Postman, Insomnia, OpenAPI, HAR y los demás formatos que lee Echolot. Pega o suelta un comando cURL para crear una solicitud a partir de él.
Selecciona varios elementos
⌘-clic añade o quita un elemento. ⇧-clic selecciona todo lo que hay entre el último elemento y este. Haz Control-clic en cualquiera de los elementos seleccionados para ver lo que puedes hacer con todos ellos:
| Comando | Qué hace |
|---|---|
| Ejecutar N elementos | Los ejecuta en la página Ejecución. |
| Editar N solicitudes… | Cambia las cabeceras, los parámetros y la autenticación de todas las solicitudes seleccionadas a la vez. |
| Nueva carpeta con N elementos | Crea una carpeta y mueve los elementos a ella. |
| Trasladar N elementos a | Los traslada a Espacio de trabajo (nivel superior) o a cualquier carpeta. |
| Trasladar N elementos a la papelera… | Pregunta y luego los traslada todos a la papelera. |
Cuando se seleccionan una carpeta y elementos de dentro, los comandos actúan sobre la carpeta.
Edita varias solicitudes a la vez
Editar N solicitudes… abre una hoja con tres pestañas: Cabeceras, Parámetros y Autenticación. Cada cambio que haces ahí va a cada solicitud seleccionada cuando haces clic en Aplicar a N solicitudes.
- Cabeceras y Parámetros enumeran todas las cabeceras o parámetros que tiene alguna de las solicitudes. Un valor en el que las solicitudes no coinciden se muestra como mixto y se queda como está en cada una, salvo que escribas uno nuevo. Una fila que les falta a algunas solicitudes dice cuántas la tienen, con Añadir a todas para dársela a todas las solicitudes. Quita una fila para eliminarla de todas las solicitudes.
- Autenticación ofrece Conservar la de cada solicitud, Heredar de la carpeta, Sin autenticación, o la misma autenticación que una de las solicitudes seleccionadas (Igual que “List orders” (Bearer Token)). Para darles a todas credenciales nuevas, define las credenciales en su carpeta y elige Heredar de la carpeta.
Todo el cambio es un solo paso: Editar › Deshacer lo revierte en todas las solicitudes.
Ajustes de la carpeta
Haz Control-clic en una carpeta y elige Ajustes de la carpeta…. La hoja tiene estas pestañas:
| Pestaña | Qué define |
|---|---|
| Autenticación | La autenticación de todas las solicitudes de dentro que no definen la suya. Heredar (el valor predeterminado) pasa hacia abajo la autenticación de la carpeta de arriba, o la del espacio de trabajo. |
| Variables | Variables para todas las solicitudes de esta carpeta. Prevalecen sobre las del espacio de trabajo y las del entorno. |
| Scripts | Un script previo a la solicitud y uno de pruebas que se ejecutan alrededor de cada solicitud de esta carpeta. |
| Documentación | Notas sobre la carpeta, guardadas en su _folder.toml. También Ofrecer estas solicitudes a los agentes como herramientas: consulta los agentes. |
Haz clic en OK para guardar. Cerrar la hoja de otra manera, o cerrar la ventana, también conserva tus ediciones.
En Alpenglow, la carpeta Orders define autenticación Bearer con {{token}}, así que cada solicitud de dentro envía
el token que captura Auth › Sign in. Una solicitud que define su propia autenticación usa esa en su lugar.
Ajustes del espacio de trabajo
Los ajustes del espacio de trabajo son lo más alto de la cadena: lo que hereda cada solicitud del espacio de trabajo. Ábrelos con Ajustes del espacio de trabajo… en el selector de espacio de trabajo, o con Control-clic en un espacio vacío del árbol de solicitudes.
| Pestaña | Qué define |
|---|---|
| Autenticación | La autenticación predeterminada de todas las solicitudes. |
| Variables | Variables del espacio de trabajo, los valores predeterminados que prevalecen sobre los entornos, las carpetas y las solicitudes. La misma lista que Espacio de trabajo en la página Entornos. |
| Scripts | Scripts que se ejecutan alrededor de todas las solicitudes. |
| Agentes | Las reglas para los agentes de IA en este espacio de trabajo. Consulta los agentes. |
| Proxy | Usar el ajuste de proxy de la app, o un proxy para este espacio de trabajo que viaja con él hasta tus compañeros y la herramienta de línea de comandos. Consulta los ajustes de la solicitud. |
| Certificados | Certificados de CA en los que confiar y certificados de cliente que presentar, por host. Consulta los ajustes de la solicitud. |
Cómo heredan las solicitudes
Para la autenticación, una solicitud usa la primera de estas que define algo: la propia solicitud, su carpeta, las carpetas que tiene encima desde la más cercana hacia fuera, y después el espacio de trabajo.
Las variables, en cambio, se suman: la solicitud ve las variables de todos los niveles, y cuando dos niveles definen el mismo nombre, gana el más cercano. El orden está en entornos.
Los scripts se ejecutan en orden alrededor de una solicitud: primero los del espacio de trabajo, luego los de cada carpeta de fuera hacia dentro y después los de la propia solicitud. Consulta scripts y pruebas.
Las cabeceras no se heredan de las carpetas; define las cabeceras compartidas con Editar N solicitudes… o en un script previo a la solicitud.
Mover una solicitud cambia lo que hereda
Una solicitud toma la autenticación, las variables y los scripts de la carpeta en la que está. Si la mueves a otra carpeta, toma los de esa. Revisa su pestaña Autenticación después de moverla si dependía de la autenticación de su carpeta anterior.
Eliminar carpetas
Trasladar a la papelera… en una carpeta pregunta antes y dice cuántas solicitudes contiene. La carpeta, sus ajustes y todas las solicitudes de dentro van a la papelera del Finder. Editar › Deshacer las recupera.