Automatización y pruebas

Usa una colección para repetir un conjunto de solicitudes, una cadena cuando una respuesta proporciona valores a la siguiente llamada y una programación cuando una solicitud guardada deba ejecutarse periódicamente.

Ejecutar una colección

Abre el ejecutor, elige el entorno y define las iteraciones. Añade una pausa entre solicitudes si hace falta y decide si un fallo de solicitud o aserción debe detener la ejecución. Inicia y revisa cada resultado.

Para variar las entradas, carga un CSV con cabeceras o un array JSON de objetos:

orderId,expectedStatus
1001,200
1002,404

La solicitud a {{baseUrl}}/orders/{{orderId}} recibe el orderId de la fila. Lee el estado esperado en el script posterior con pm.iterationData.get("expectedStatus"). Cada fila proporciona una iteración.

El resultado registra estado, duración y aserciones fallidas. El historial conserva el nombre del archivo de datos y el número de filas. Exporta JUnit XML para CI o HTML para lectura. Revisa los informes antes de compartirlos, especialmente si la API devuelve datos personales o confidenciales.

Escribir un script concreto

El script previo prepara valores antes de la llamada. El posterior verifica la respuesta. Coloca este ejemplo en el editor posterior:

pm.test("Expected status", function () {
    const expected = Number(pm.iterationData.get("expectedStatus") || 200);
    pm.expect(pm.response.code).to.equal(expected);
});

if (pm.response.code === 200) {
    const body = pm.response.json();
    pm.environment.set("orderId", String(body.id));
}

Consulta pm.response.text(), pm.response.json(), pm.response.headers.get("Content-Type") y pm.response.responseTime. La API incluye pm.environment, pm.variables, pm.collectionVariables, metadatos de pm.request de solo lectura, pm.iterationData, pm.test, aserciones pm.expect de estilo Chai y console.log.

pm.sendRequest realiza una llamada HTTP adicional con callback, que termina antes de que la función retorne. Los scripts se ejecutan en un entorno JavaScript aislado con límite de cinco segundos, sin módulos Node.js ni acceso a .NET. Revisa los scripts importados según estas APIs; no están disponibles todas las extensiones de Postman. No se admiten scripts ni autenticación editable a nivel de colección.

Pasar valores por una cadena

Crea la cadena, añade solicitudes guardadas en el orden necesario y selecciona el entorno. Una extracción JSONPath como $.id guarda el valor de la respuesta en orderId; el siguiente paso puede usar {{orderId}}.

Las condiciones comprueban si una variable existe, coincide con un valor o contiene texto, combinando comprobaciones con AND u OR. Si la condición no se cumple, el paso se omite. Activa la detención en caso de error cuando los pasos siguientes dependan del anterior. Consulta los detalles para distinguir un fallo de un paso omitido.

Crear un mock de escritorio

Abre el editor de mocks, crea una entrada de servidor y añade rutas con protocolo, método u operación, ruta, respuesta y retraso opcional. Las plantillas, la duplicación y la comprobación de precedencia ayudan a preparar las rutas. También puedes guardar una respuesta HTTP del historial como ruta.

Las rutas HTTP aceptan una respuesta exacta o datos generados por contrato. Revisa ejemplos y escenarios y consulta contratos para importar modelos o fijar una versión publicada. Los mocks de escritorio también admiten respuestas gRPC y secuencias de mensajes WebSocket.

Estos mocks son gratuitos y responden a llamadas dentro de Echo, sin abrir un puerto de red. Una URL HTTP compartida requiere alojamiento público de pago. Para reglas en tu aplicación .NET o snapshots offline, consulta los paquetes.

Programar una solicitud

Guarda la solicitud, abre su programación y elige entorno, expresión cron y modo de ejecución. Define si está activa y revisa la próxima ejecución. Por ejemplo, */15 * * * * solicita una ejecución cada quince minutos.

La programación de escritorio necesita que Echo y la máquina sigan funcionando. La alojada continúa en los servidores Gapfy con la aplicación cerrada y requiere un plan de pago y el permiso correspondiente. Acepta HTTP y queries o mutations GraphQL, con al menos cinco minutos entre ejecuciones. No admite gRPC, WebSocket, SSE ni subscriptions GraphQL.

Espera la confirmación de entrega al servidor. Un guardado en cola o una sincronización normal no son esa confirmación. Consulta el último resultado, el mensaje de fallo y la duración de referencia. Ajusta el umbral de regresión o restablece la referencia cuando deje de resultar útil. Maestro también muestra resultados alojados y resúmenes sincronizados de ejecuciones de colecciones.

Ejecutar desde el terminal

La CLI gapfy-echo ejecuta carpetas en formato Echo sin abrir el escritorio. Requiere .NET 11 y acceso al paquete en el feed Gapfy. Es distinta de la herramienta estable echo-mock de la guía de paquetes.

Con la CLI instalada, ejecuta una exportación de carpeta vinculada:

gapfy-echo run collection ./orders --env Development --data ./rows.csv --bail --junit ./results/run.xml --html ./results/run.html

Las opciones incluyen iteraciones, tiempo de espera por solicitud, proxy y diagnóstico detallado. Para listar o descargar colecciones del servidor, usa --server y una clave de aplicación con RunCollections. Las llamadas se ejecutan en la máquina de la CLI y los resultados no se suben automáticamente.

Las cadenas utilizan archivos complementarios explícitos chains/*.chain.json, run chain y --chain. La exportación de carpeta vinculada no crea esos archivos. OAuth con inicio de sesión en el navegador no está disponible en la CLI. Los códigos de salida son 0 para finalización sin fallos, 1 para fallo de solicitud o aserción, 2 para errores de uso, carga o informe y 130 para cancelación. Revisa el número ejecutado: una colección vacía puede terminar sin ejecutar solicitudes.

Los asistentes de IA pueden preparar aserciones, conjuntos de pruebas y mejoras de cadenas para revisión.