Valores dinámicos

Cuando está depurando un endpoint en Apidog, a menudo necesita fabricar un valor, un nombre, una dirección u otros puntos de datos en los parámetros de la petición, el cuerpo de la petición, etc. Aquí es donde la función de valores dinámicos resulta útil.

Los valores dinámicos le permiten generar un nuevo valor basado en una regla predefinida cada vez que envía una petición. Esto ayuda a optimizar el proceso de depuración y garantiza que cada petición contenga datos únicos.

Primeros pasos

En un endpoint, cambie a la pestaña Run.

Para el parámetro que desea dinamizar, elimine el valor original y, a continuación, haga clic en el icono de varita mágica situado a la derecha del valor. En este ejemplo, seleccionaré el parámetro name.

Haga clic en Data generator y elija el tipo de valor dinámico que necesita, como Person.firstName.

Haga clic en Insert para insertar el valor dinámico en el parámetro.

Haga clic en Send. Puede ver en la Actual request que el nombre real enviado es "Jennifer".

Envíe la petición de nuevo y se generará dinámicamente un nuevo nombre.

Uso de valores dinámicos en el cuerpo JSON

Si necesita publicar un cuerpo JSON y algunos valores del JSON deben generarse dinámicamente, también puede usar valores dinámicos.

Busque un endpoint POST con un cuerpo JSON y cambie a la pestaña Run.

En el cuerpo JSON, haga clic en Generate automatically -> Generate field names y obtendrá los nombres de las propiedades definidas en la especificación.

Coloque el cursor en el lugar correcto, haga clic en Insert dynamic value y seleccione Data Generator.

Elija el tipo de dato adecuado y haga clic en Insert.

Añada valores para todos los campos.

Haga clic en Send. Puede ver el cuerpo JSON real enviado en la sección Actual request.

Si envía la petición de nuevo, los valores dinámicos generarán un nuevo cuerpo JSON.

Uso de valores dinámicos en una expresión personalizada

Si necesita personalizar una cadena de información y hay algunos valores en la información que deben generarse dinámicamente, también puede hacer clic en Custom expression e introducir la expresión de valor dinámico.

Haga clic en la expresión dinámica para abrir el cuadro de entrada.

Genere el contenido esperado introduciendo expresiones de valores dinámicos mediante métodos como la concatenación. Puede obtener una vista previa de la información generada en tiempo real debajo.

Haga clic en Insert. Puede ver expresiones personalizadas en la sección de valores de parámetros.

Estos son algunos ejemplos comunes de valores dinámicos personalizados. También puede hacer clic en Dynamic Values Modules para ver más métodos de valores dinámicos.

Contenido personalizado deseado	Expresión personalizada	Valor de retorno de ejemplo	Concatenación de métodos y significado
Nombre de usuario aleatorio con marca de tiempo	`{{$internet.userName}}_{{$date.now}}`	"Kattie_Rice64_2024-09-04T05:51:42.413Z"	Use `{{$internet.userName}}` para generar un nombre de usuario aleatorio, use `{{$date.now}}` para obtener la hora actual y concaténelos usando literales de plantilla.
Dirección de correo electrónico aleatoria con dominio de empresa	`{{person.lastName}}@{{$company.name	lower}}.com`	"Kole.Haag@schmidt-schoen.com"
Dirección aleatoria con número de calle y número de apartamento	`{{$location.buildingNumber}} {{$location.street}}, Apt. {{$number.int(min=1,max=1000)}}, {{$location.city}}, {{$location.state(abbreviated=true)}} {{$location.zipCode}}`	"723 Klein Inlet, Apt. 814, North Myron, DE 67605"	Use varios métodos para generar una dirección detallada, incluidos el número de calle, el nombre de la calle, el número de apartamento, la ciudad, el estado y el código postal.
Nombre de empresa aleatorio con sector y tipo de empresa	`{{$company.buzzAdjective}} {{$company.buzzNoun}} {{$company.name}}`	"web-enabled architectures Fay Inc"	Use el método `company` para generar un nombre de empresa con descripción del sector y tipo de empresa.
Fecha aleatoria dentro del último año	`{{$date.past(years=1)}}`	"2023-10-24T09:25:24.109Z"	Use el método `{{$date.past(years=1)}}` para generar una fecha aleatoria dentro del último año.
Precio aleatorio con símbolo de moneda	`{{$finance.currencySymbol}}{{$commerce.price}}`	"KM12.89"	Use `{{$finance.currencySymbol}}` para generar un símbolo de moneda aleatorio, use `{{$commerce.price}}` para generar un precio aleatorio y concaténelos.
Descripción de producto aleatoria	`{{$commerce.productAdjective}} {{$commerce.productMaterial}} {{$commerce.product}} - {{$lorem.sentences(min=2,max=4)}}`	"Small Wooden Pizza - Thema copiose dens adinventitias a. Causa uxor terreo defleo vitiosus animi. Ademptio possimus decet considero absorbeo sursum rem circumvenio antiquus curatio. Adipisci addo tredecim carbo."	Use los métodos `{{$commerce.productAdjective}}` y `{{$lorem.sentences(min=2,max=4)}}` para generar texto que contenga características y descripciones de productos.
Frase aleatoria con hashtag	`#{{$lorem.slug(min=1,max=3)}} {{$lorem.sentence(min=1,max=3)}}`	"#provident-quidem-tempore Vita comprehendo id."	Use `{{$lorem.slug(min=1,max=3)}}` para generar un hashtag aleatorio y concatenarlo antes de la frase.
Dirección IP aleatoria con número de puerto	`{{$internet.ipv4}}::{{$number.int(min=1024,max=65535)}}`	"246.222.133.63::56332"	Use `{{$internet.ipv4}}` para generar una dirección IP aleatoria, use `{{$number.int(min=1024,max=65535)}}` para generar un número de puerto y concaténelos.
URL aleatoria con parámetros de consulta	`{{$internet.url}}?{{$lorem.slug}}={{$lorem.word}}`	"https://nippy-bob.name/?nemo-provident-clementia=blandior"	Use `{{$internet.url}}`, `{{$lorem.slug}}` y `{{$lorem.word}}` para generar una URL aleatoria con parámetros de consulta.
Ruta de archivo aleatoria	`/path/to/{{$lorem.slug}}/{{$system.fileName}}`	"/path/to/caritas-solio-vilicus/across.img"	Use `{{$lorem.slug}}`, `{{$system.fileName}}` y la concatenación de cadenas para generar una ruta de archivo aleatoria.
Nombre de tabla de base de datos aleatorio	`table_{{$string.alphanumeric(length=5)	lower}}`	"table_brxlr"
Fragmento de código HTML aleatorio	`<p>{{$lorem.sentence}} <a href="{{$internet.url}}">{{$lorem.word}}</a></p>`	`<p>Calamitas velociter una succurro depopulo. <a href="https://feline-king.name/">comminor</a></p>`	Use `{{$lorem.sentence}}` y `{{$internet.url}}` para generar un fragmento de código HTML aleatorio que contenga un enlace.
Encabezado de petición HTTP aleatorio	`{ "User-Agent": {{$internet.userAgent}}, "Referer": {{$internet.url}} }`	`{ "User-Agent": Opera/13.25 (Macintosh; Intel Mac OS X 10.7.9 U; HE Presto/2.9.171 Version/12.00), "Referer": https://queasy-dusk.info/ }`	Use `{{$internet.userAgent}}` y `{{$internet.url}}` para generar un encabezado de petición HTTP aleatorio que contenga User-Agent y Referer.

Casos de uso de variables dinámicas

Las variables dinámicas tienen una amplia gama de aplicaciones en las pruebas de API. Estos son algunos ejemplos típicos:

Simulación de datos del mundo real: Necesita probar cómo gestiona su API distintos tipos de datos, como nombres de usuario, direcciones o direcciones de correo electrónico en varios formatos. Con variables dinámicas, puede generar fácilmente grandes cantidades de datos de prueba que se asemejan a escenarios del mundo real, lo que mejora la cobertura de las pruebas.

Generación de valores únicos: En determinados escenarios de prueba, necesita garantizar la unicidad de los datos, como generar números de pedido, ID de usuario o ID de transacción. Las variables dinámicas pueden generar valores únicos basados en marcas de tiempo o números aleatorios, lo que evita conflictos de datos y garantiza resultados de prueba precisos.

Optimización de la gestión de datos: En lugar de modificar manualmente los datos para cada ejecución de prueba, use variables dinámicas para generar automáticamente los datos necesarios. Esto le ahorra una cantidad significativa de tiempo y esfuerzo, lo que aumenta la eficiencia de sus pruebas.

Insertar valor dinámico manualmente

En el campo de entrada donde necesita insertar una variable dinámica, puede escribir {{$ para activar la lista de variables dinámicas.

Puede localizar rápidamente la variable deseada mediante uno de estos métodos:

Entrada completa: Introduzca con precisión el nombre completo de la variable dinámica, por ejemplo, $timestamp.

Coincidencia aproximada: Introduzca palabras clave parciales, como time, y el sistema filtrará y mostrará automáticamente las variables dinámicas coincidentes.

Seleccione la variable dinámica de destino para insertarla en el campo de entrada.

TIP

Este método no admite añadir directamente parámetros ni funciones a la variable dinámica.

Generador de datos

Use el generador de datos; puede generar cualquier dato personalizado según lo necesite.

Pase el cursor sobre el campo de entrada del parámetro y haga clic en el icono de varita mágica que aparece para abrir el panel Data Generator, más potente.

Puede encontrar la variable dinámica deseada en el panel mediante dos métodos:

Buscar por tipo de variable: Localice rápidamente el ámbito de variable deseado seleccionando un tipo de variable dinámica, como "Date", "String", "Number", etc., para una mayor eficiencia de búsqueda.

Buscar por palabra clave: Introduzca palabras clave en el cuadro de entrada "Type" situado en la parte superior, como "time," y el sistema filtrará y mostrará automáticamente las variables dinámicas coincidentes, lo que le facilitará localizarlas rápidamente.

Una vez que haya seleccionado la variable dinámica deseada, puede refinarla aún más con las siguientes operaciones para satisfacer necesidades de generación de datos más granulares:

Añadir métodos: Algunas variables dinámicas admiten métodos adicionales, como {{$date.now}}, que puede usar el método addDays para añadir días y generar datos para una fecha específica.

Añadir funciones de procesamiento: Todos los resultados de variables dinámicas pueden procesarse con funciones; por ejemplo, usando la función md5 para cifrar una cadena y generar datos de prueba que cumplan requisitos de seguridad.

El área Expression muestra claramente las variables dinámicas, los métodos y las funciones seleccionados actualmente, lo que facilita revisarlos y modificarlos.

El área Preview muestra en tiempo real datos de muestra generados por la variable dinámica. Haga clic en el botón Refresh al final del área Preview para generar nuevos datos de muestra, lo que le permite ver fácilmente los efectos de la generación de datos.

Haga clic en los datos de muestra del área Preview para copiar automáticamente el contenido, lo cual resulta práctico para pegarlo donde sea necesario.

Constante

Puede usar Constant para envolver un fragmento de texto estático en la sintaxis de Dynamic Value, lo que le permite añadir funciones de procesamiento posteriormente. Los casos de uso comunes incluyen aplicar hash MD5, codificación Base64 o cambiar mayúsculas y minúsculas.

Al usar una constante, introduzca el valor original y añada manualmente las funciones de procesamiento necesarias en la sintaxis. El sistema gestionará automáticamente el cifrado o la conversión durante la ejecución.

Si el valor es puramente estático y no requiere ningún procesamiento, puede introducirlo directamente como texto sin formato sin usar Constant.

Configuración del idioma/país de los datos

Las variables dinámicas de Apidog admiten la generación de datos de muestra en diferentes idiomas para satisfacer sus necesidades de prueba en entornos multilingües. Así se hace:

Abra el panel Data Generator.

Para tipos de variables dinámicas distintos de fecha y hora, haga clic en el botón de configuración situado en la esquina superior derecha de la variable dinámica y seleccione el idioma de destino.

Para tipos de variables dinámicas de fecha y hora, puede especificar el idioma y el formato usando los métodos format y locale.

Operaciones y formato de fechas potentes

Apidog va más allá de proporcionar abundantes valores dinámicos de fecha y hora; está comprometido con simplificar su proceso de desarrollo. Estas son algunas de las funciones que puede lograr fácilmente:

Ajuste flexible de tiempo: Con el método add, puede añadir o restar fácilmente unidades de tiempo en función de la hora actual. Por ejemplo, {{$date.now|addHours(-3)}} devolverá la fecha 3 horas anterior a la hora actual.

Formato de fecha diverso: Con el método format, puede dar formato a las fechas en distintos formatos según sea necesario. Por ejemplo, {{$date.now|formatISO}} dará formato a la fecha según el estándar ISO 8601.

Control preciso de zona horaria: Al establecer el parámetro timezone, puede controlar fácilmente la zona horaria de la fecha. Por ejemplo, {{$date.now|format('yyyy-MM-dd HH:mm:ss',timezone='America/Port-au-Prince')}} devolverá la fecha correspondiente a la hora actual en la zona horaria UTC+8:00.

Variables dinámicas comunes

Para ayudarle a sacar el máximo partido de Dynamic Values de Apidog, hemos compilado una lista completa de valores disponibles junto con ejemplos claros. Puede hacer clic en Dynamic Values Modules para encontrar rápidamente los valores que necesita y aprender a usarlos de forma eficaz.

TIP

También puede pasar el cursor del ratón sobre una expresión de Dynamic Value dentro de la aplicación Apidog para ver una breve descripción y ejemplos.

Primeros pasos#

Uso de valores dinámicos en el cuerpo JSON#

Uso de valores dinámicos en una expresión personalizada#

Casos de uso de variables dinámicas#

Insertar valor dinámico manualmente#

Generador de datos#

Constante#

Configuración del idioma/país de los datos#

Operaciones y formato de fechas potentes#

Variables dinámicas comunes#

Primeros pasos

Uso de valores dinámicos en el cuerpo JSON

Uso de valores dinámicos en una expresión personalizada

Casos de uso de variables dinámicas

Insertar valor dinámico manualmente

Generador de datos

Constante

Configuración del idioma/país de los datos

Operaciones y formato de fechas potentes

Variables dinámicas comunes