Tu primera petición — Docs de Mariner

Mariner arranca con una pequeña colección de ejemplo para que envíes algo en los primeros diez segundos. Esta página recorre esa petición y nombra cada parte de la ventana que usarás después.

Envía la petición de ejemplo

En el primer arranque Mariner crea un workspace llamado Personal con una colección Welcome to Mariner: peticiones contra httpbin.org que devuelven lo mismo que les mandas — tres en la raíz y una carpeta por superficie del editor (Auth, Variables, Body, Post-Response, Contract, Response states). La primera ya está abierta.

Pulsa ⌘↵ (o el botón Send). La respuesta aparece en el panel inferior con su estado, tamaño y tiempo.
Abre la pestaña Tiempos para ver en qué se fueron los milisegundos — DNS, TCP, TLS, espera, descarga.
Abre la segunda petición, POST · Echo body, y vuelve a pulsar ⌘↵: el body JSON del editor vuelve dentro de la respuesta.
Abre GET · Variables in action. Su URL empieza por {{baseUrl}}, una variable ya definida en el entorno Default. Pasa el cursor por el token para ver a qué resuelve.

El editor de peticiones

La barra sobre el editor se lee de izquierda a derecha: método, URL, el menú ⋯ y Send. Al entrar en la URL, el campo deja de recortar: envuelve y crece hacia abajo sobre el panel, así que una URL larga se lee mientras la editas y vuelve a ser compacta en cuanto sales.

Debajo están la URL resuelta — la que saldrá de verdad por la red — y un chip {} con el número de tokens de los que depende la petición. Abre el chip para ver la URL entera en tantas líneas como necesite, y la lista de cada {{token}} y cada :slug con lo que aporta; ver Configurar entornos.

Params — parámetros de query, más lo que escribiste directamente en la URL (en solo lectura), más las variables de path como :id.
Headers — filas clave/valor con autocompletado de nombres estándar. Las cabeceras que Mariner añade por su cuenta (Content-Type para un body JSON, por ejemplo) aparecen en una sección de cabeceras temporales en solo lectura.
Body — ninguno, raw, JSON, form-urlencoded o multipart. El JSON tiene formateador e indicador de válido/inválido en vivo; multipart permite adjuntar archivos.
Auth — ver Autenticación.
Variables — valores que pertenecen solo a esta petición; ver Variables y secretos.
Contract — la forma contra la que se mide cada respuesta a esta petición; ver Contratos.
Post-Response — reglas que copian valores de la respuesta a variables.

Toda tabla clave/valor tiene un botón Bulk edit: pega líneas clave: valor y aplica con ⌘↵.

El panel de respuesta

Body — Pretty, Raw, Tree (solo JSON) y Preview (HTML). ⌘F busca dentro del body; ⌘G salta a la siguiente coincidencia. Los bodies grandes se recortan en el visor, nunca en el archivo que guardas con Save body to file….
Headers y Cookies — una fila por elemento, con el recuento en la pestaña.
Tiempos — la cascada. Las fases grises son preparación de Mariner; las de color, la red.

La pestaña Tiempos de un GET a httpbin.org: una cascada con Preparación, Resolución DNS, Conexión TCP, Handshake TLS, Petición enviada, Esperando (TTFB), Descarga y Procesamiento, y un total de 688 ms — TIEMPOS · en qué se fueron 688 ms — 157 de ellos esperando el primer byte

Captures — lo que extrajeron las reglas de Post-Response esta vez.

La franja sobre las pestañas muestra el estado, el tiempo total, si se reutilizó la conexión, la versión HTTP, la IP remota, el tamaño, el ahorro por gzip y — cuando el servidor las envía — las cabeceras de rate limit y el desfase de reloj entre el servidor y tu Mac.

Arranque en frío y cancelar

Clic derecho en Send para Send (cold start): Mariner descarta la conexión en caché para que el siguiente timing incluya DNS, TCP y TLS desde cero. El menú ⋯ tiene además un Cold mode persistente para una petición que nunca deba tocar caché.

Mientras una petición corre, Send se convierte en Cancel. Cada pestaña tiene su propio ejecutor, así que cancelar una nunca afecta a otra.

Pestañas y paleta

⌘T crea una petición en la colección activa.
Las peticiones se abren en pestañas: ⌘1–⌘9 salta a una, ⌘⌥→ / ⌘⌥← se mueve entre ellas, ⌘W cierra la actual. El techo son veinte: cada pestaña retiene su última respuesta, así que el tope es lo que evita que una sesión larga se vaya sumando. Mariner rechaza la vigesimoprimera en vez de cerrarte una.
⌘⌥9 oculta el editor y ⌘⌥0 la respuesta, para que cualquiera de los dos ocupe toda la ventana.
⌘K abre la paleta de comandos: cada petición, colección, entorno y acción en una sola lista con búsqueda difusa. Es la forma más rápida de enviar una petición que aún no has abierto.