En el Modo Design-first de Apidog, una vez que haya especificado un endpoint en la pestaña Edit, puede hacer clic en la pestaña Run para cambiar a la interfaz de envío de peticiones. Aquí, la petición correspondiente se genera automáticamente en función de las especificaciones del endpoint que usted haya definido.Para los parámetros path, los parámetros query, los headers y el body de tipo form-data o x-www-form-urlencoded, si ha especificado un example en la especificación del endpoint, este ejemplo completará automáticamente el campo value en la interfaz Run como valor inicial del parámetro de la petición.
TIP
Si los parámetros, como el nombre del parámetro, la descripción, el tipo o el ejemplo en la endpoint specification, se modifican y se guardan en la pestaña Edit, los campos correspondientes en la pestaña Run también se actualizarán en consecuencia. Cualquier cambio realizado en la especificación se reflejará en todo el proceso de desarrollo, manteniendo la coherencia y la precisión.
Si el cuerpo de su petición es de tipo JSON o XML, puede generar automáticamente el cuerpo de la petición dentro de Apidog sin tener que construirlo manualmente.
Ejemplos de cuerpo de petición y contenido inicial#
Modo Design-first
Modo Request-first
Si la especificación de su endpoint incluye un ejemplo de cuerpo definido, este ejemplo aparecerá en la pestaña Run como contenido inicial del cuerpo.Si no hay ningún ejemplo de cuerpo definido en la especificación del endpoint, el campo del cuerpo en la pestaña Run se dejará en blanco. Sin embargo, puede hacer clic en Auto-generate para crear una estructura de cuerpo que se ajuste a sus requisitos.
Apidog proporciona una variedad de opciones de generación automática de datos para satisfacer distintas necesidades. Puede seleccionar entre varios métodos de generación en el menú desplegable Auto-generate:
Función: Selecciona manualmente un ejemplo de cuerpo de petición predefinido.
Caso de uso: Cambiar manualmente entre ejemplos predefinidos para diferentes escenarios de negocio, como peticiones normales, peticiones de excepción o pruebas de valores límite.
Al hacer clic en Auto-generation Preference, se abre una ventana emergente donde puede seleccionar las reglas que prefiere para generar datos automáticamente.
Usar primero los valores de ejemplo
Función: Si se definen valores de ejemplo en el esquema de datos de la petición, se utilizarán para la generación automática. Si no se configuran valores de ejemplo, se generará un valor aleatorio según las reglas de Mock.
Caso de uso: Ideal para escenarios en los que algunos campos requieren valores fijos, mientras que otros pueden generarse dinámicamente.
Usar primero los valores predeterminados
Función: Si se definen valores predeterminados en el esquema de datos de la petición, se utilizarán para la generación automática. Si no se configuran valores predeterminados, se generará un valor aleatorio según las reglas de Mock.
Caso de uso: Adecuado para escenarios de depuración en los que deben conservarse valores preestablecidos.
Usar valor mock
Función: Genera datos basados en reglas de Smart Mock.
Caso de uso: Generar rápidamente datos de prueba completos.
Generar solo nombres de campos
Función: Genera solo nombres de campos utilizando el esquema de datos de la petición y deja los valores en blanco.
Caso de uso: Útil para escenarios de prueba en los que deben completarse manualmente valores específicos.
Usar ejemplo de petición
Función: Selecciona aleatoriamente un ejemplo de petición predefinido.
Caso de uso: Cambiar rápidamente entre diferentes escenarios de negocio, como peticiones normales o de excepción.
Puede utilizar Valores dinámicos para generar valores tanto para los parámetros de la petición como para el cuerpo de la petición. Esto permite que los valores dinámicos se simulen mediante mock y se inserten automáticamente en la petición cada vez que se envía.Junto al cuadro de entrada de cada parámetro de petición, verá un icono de varita mágica para variables dinámicas; al hacer clic en este icono, se insertará un valor dinámico.
Del mismo modo, en el cuerpo de la petición, puede hacer clic en el botón Insert Dynamic Value para insertar valores dinámicos dentro de cuerpos JSON o XML.
