Mock personalizado

Apidog proporciona potentes funciones de personalización de mock que le ofrecen un control detallado sobre las respuestas de API. Este documento presenta dos enfoques para personalizar datos de mock:

Personalización a nivel de campo: controle campos específicos mientras utiliza mock inteligente para otros

Personalización completa de la respuesta: defina respuestas de mock completas con expectativas (fijas, condicionales o dinámicas)

Personalización a nivel de campo

A veces necesita definir valores específicos para ciertos campos mientras permite que Apidog genere automáticamente el resto. Apidog ofrece métodos flexibles para el control a nivel de campo.

Establecer valores de campo personalizados

1. Valores fijos

Especifique un valor estático en el campo de mock de la especificación del endpoint. Apidog siempre devolverá este valor exacto para ese campo, mientras utiliza mock inteligente para los campos no especificados.

Ejemplo:

2. Valores dinámicos con Faker.js

Genere datos aleatorios realistas utilizando los valores dinámicos de Apidog (basados en Faker.js). Utilice la sintaxis:

{{$category.method}}

Ejemplos comunes:

Expresión	Resultado de ejemplo
`{{$person.fullName}}`	Rachel Wheeler
`{{$internet.email}}`	Arno.Huels33@yahoo.com
`{{$commerce.productName}}`	Elegant Plastic Bike

Seleccione valores dinámicos directamente desde el menú desplegable:

3. Métodos Faker parametrizados

Pase parámetros a los métodos de valores dinámicos para la generación de datos especializados utilizando la sintaxis mejorada de Faker.js de Apidog.

Ejemplos:

Caso de uso	Expresión	Descripción
Rango de enteros	`{{$number.int(min=0,max=10000)}}`	Entero aleatorio entre 0 y 10.000
Teléfono legible	`{{$phone.number(style='human')}}`	Formato de teléfono legible para humanos
Múltiplo de N	`{{$number.int(multipleOf=3)}}`	Entero divisible entre 3
Elemento de arreglo	`{{$helpers.arrayElement(['red','blue','green'])}}`	Color aleatorio del arreglo
Rango de fechas	`{{$date.between(from='2024-01-01',to='2024-12-31',format='yyyy-MM-dd')}}`	Fecha dentro del rango especificado

Explore la lista completa de módulos, métodos y parámetros en la documentación de módulos de valores dinámicos.

4. Concatenar múltiples expresiones

Combine texto estático y múltiples expresiones dinámicas para generar valores de campo complejos.

Ejemplo: generación de dirección completa

{{$location.streetAddress}}, {{$location.city}}, {{$location.state}}, {{$location.zipCode}}, {{$location.country}}

Salida de ejemplo:

8507 Hudson Alley, Rochester, Wisconsin, 96512, United States

Cada componente se genera dinámicamente, creando direcciones únicas y realistas para cada llamada de API de mock.

Configuraciones regionales de mock

Apidog admite configuraciones regionales de mock personalizables, lo que le permite generar datos de prueba dinámicos en diferentes idiomas y formatos que coincidan con su región o audiencia objetivo. Para obtener más información sobre cómo configurar configuraciones regionales de mock, visite Idioma de mock (configuraciones regionales).

Personalización completa de la respuesta (expectativas de mock)

Para tener control completo sobre las respuestas de mock, utilice expectativas de mock. Esta función le permite definir respuestas fijas, condicionales o dinámicas.

Crear expectativas de mock

Respuestas fijas

Devuelva los mismos datos para cada petición creando una expectativa incondicional.

Pasos:

Haga clic en Nueva expectativa

Añada un nombre de expectativa y deje las condiciones en blanco

Complete los datos de respuesta que desea devolver y, a continuación, guarde

Copie y utilice la URL de mock proporcionada para acceder a este endpoint

Respuestas condicionales

Devuelva diferentes datos de mock según los parámetros de la petición. El motor de mock evalúa las condiciones de arriba hacia abajo y devuelve la primera expectativa coincidente.

Tipos de condición admitidos:

Tipo de parámetro	Descripción
Parámetros de consulta	Cadenas de consulta de URL
Parámetros de ruta	Segmentos dinámicos de URL
Parámetros de encabezado	Encabezados HTTP
Parámetros de cookie	Valores de cookies
Parámetros del cuerpo	Campos del cuerpo JSON (mediante ruta JSON)

Comportamiento de las condiciones

Varias condiciones se combinan con lógica AND (todas deben coincidir)

Si ninguna condición coincide, Apidog recurre a la prioridad del método de Mock en Configuración del proyecto → Configuración de funciones → Configuración de Mock

Limitaciones

Los parámetros del cuerpo admiten solo JSON, no XML

Las condiciones de parámetros no pueden usar {{variables}}

El formato del cuerpo de la petición debe coincidir con la especificación de la API (por ejemplo, form-data, JSON)

Las condiciones de dirección IP pueden restringir las respuestas a IP específicas

Datos de mock dinámicos

Las expectativas de mock admiten datos dinámicos y aleatorizados mediante la sintaxis de plantillas de Faker.js y Nunjucks.

Ejemplo:

{
    "data": [
        {% for i in range(0, 20) %}
        {% if i>1 %},{% endif %}
        {
            "id": {{i}},
            "firstname": "{{$person.firstName}}",
            "lastname": "{{$person.lastName}}"
        }
        {% endfor %}
    ],
    "success": true
}

Esto genera:

Arreglo de 20 objetos de usuario (id de 0 a 19)

Cada uno con nombres y apellidos generados aleatoriamente

Un campo constante "success": true

Notas de sintaxis:

Sintaxis	Propósito
`{{$...}}`	Invoca Faker.js para valores aleatorios
`{% for ... %}`	Estructura de bucle de Nunjucks
`{{i}}`	Variable de bucle de Nunjucks (no es una variable de Apidog)

Diferencias importantes

Apidog utiliza {{$person.firstName}} en lugar de faker.person.firstName() nativo de Faker.js

Las variables de proyecto/entorno de Apidog ({{variable}}) no están disponibles en las expectativas de mock

Consulte la documentación de Faker.js y Nunjucks para conocer la sintaxis completa

Funciones avanzadas

Encabezados de respuesta personalizados

Añada encabezados personalizados a las expectativas de mock para simular autenticación, paginación u otros comportamientos de API.

Propiedades avanzadas de respuesta

Configure propiedades adicionales de respuesta en la pestaña Más:

Propiedad	Propósito	Valor predeterminado
Código de estado HTTP	Simular errores o casos especiales	200
Retraso de respuesta	Simular latencia de red (milisegundos)	0

Habilitar/deshabilitar expectativas

Active o desactive expectativas de forma independiente para entornos de mock locales y en la nube desde la lista de expectativas.

Resumen

Las funciones de mock personalizado de Apidog proporcionan:

Personalización flexible de campos con valores fijos o dinámicos

Control completo de la respuesta mediante expectativas de mock

Lógica condicional para respuestas basadas en parámetros

Generación de datos dinámicos mediante Faker.js y Nunjucks

Simulación avanzada con encabezados personalizados, retrasos y códigos de estado

Estas funciones le permiten crear simulaciones de API robustas y de alta fidelidad que reflejan con precisión el comportamiento de producción.

Personalización a nivel de campo#

Establecer valores de campo personalizados#

1. Valores fijos#

2. Valores dinámicos con Faker.js#

3. Métodos Faker parametrizados#

4. Concatenar múltiples expresiones#

Personalización completa de la respuesta (expectativas de mock)#

Crear expectativas de mock#

Respuestas fijas#

Respuestas condicionales#

Datos de mock dinámicos#

Funciones avanzadas#

Encabezados de respuesta personalizados#

Propiedades avanzadas de respuesta#

Habilitar/deshabilitar expectativas#

Resumen#

Personalización a nivel de campo

Establecer valores de campo personalizados

1. Valores fijos

2. Valores dinámicos con Faker.js

3. Métodos Faker parametrizados

4. Concatenar múltiples expresiones

Personalización completa de la respuesta (expectativas de mock)

Crear expectativas de mock

Respuestas fijas

Respuestas condicionales

Datos de mock dinámicos

Funciones avanzadas

Encabezados de respuesta personalizados

Propiedades avanzadas de respuesta

Habilitar/deshabilitar expectativas

Resumen