动态值

应用场景#

使用入门#

Apifox 版本号需 >=2.6.15

1.

在接口中，切换到 “运行” 选项卡。

2.

对于要动态化的参数，可以先删除原始值，然后单击值右侧的 魔棒 图标。

3.

点击 “数据生成器”，然后选择所需的动态值类型，例如名字。

4.

点击 “插入” 将动态值表达式插入到参数中。

5.

点击 “发送”，你可以在 “实际请求” 中看到发送的实际名称。

6.

再次发送请求，将动态生成一个新的名字。

在 JSON 请求体中使用动态值#

1.

找到一个带有 JSON 请求体的 POST 接口，并切换到运行选项卡。

2.

在 JSON 请求体中，单击 “自动生成 -> 仅生成字段名”，你将获得在 API 文档中定义的属性名称。

3.

将光标定位在正确的位置，单击 “动态值”，然后选择 “数据生成器”。

4.

选择适当的数据类型，然后单击 “插入”。

5.

为所有字段添加值。

6.

单击 “发送”。你可以在 “实际请求” 部分中看到实际发送的 JSON 请求体。

7.

如果再次发送请求，动态值将生成新的 JSON 请求体。

在自定义表达式中使用动态值#

1.

单击 “动态值” 图标，然后选择 “自定义表达式” 以打开输入框。

2.

通过拼接等方法输入 “动态值表达式” 来生成预期内容，你可以在下方实时预览生成的信息。

3.

单击 “插入”，你可以在参数值部分看到自定义表达式。

4.

除此之外，你还可以使用 Nunjucks 模板引擎语法来辅助生成。
例如：

这将生成 20 个随机用户数据，其中包含随机的名字和姓氏。

手动插入动态值#

数据生成器#

按变量类型搜索： 通过选择动态值类型（例如日期、字符串、数字等）快速定位所需的变量范围，提高搜索效率。

按关键词搜索： 在顶部的 “类型” 输入框中输入关键词（例如时间、字符串等），系统会自动过滤并显示匹配的动态值，方便你快速定位。

添加方法： 一些动态值支持附加方法，例如 {{$date.now}} 可以使用 addDays 方法添加天数以生成特定日期的数据。

添加处理函数： 所有动态值结果都可以使用函数进行处理，例如，使用 md5 函数对字符串进行加密以生成满足安全要求的测试数据。

设置数据语言/国家#

1.

打开 “数据生成器” 面板。

2.

对于 “日期” 和 “时间” 以外的动态值类型，单击动态值类型右上角的切换组件，然后选择相应的目标语言即可。

3.

对于 “日期” 和 “时间” 的动态值类型，你可以使用 format 和 locale 方法指定语言和格式。

强大的日期操作和格式化#

灵活的时间调整： 使用 add 方法，你可以轻松地根据当前时间添加或减去时间单位。例如，{{$date.now|addHours(-3)}} 将返回比当前时间早 3 小时的日期。

多样化的日期格式化： 使用 format 方法，你可以根据需要将日期格式化为不同的格式。例如，{{$date.now|formatISO}} 将根据 ISO 8601 标准格式化日期。

精确的时区控制： 通过设置 timezone 参数，你可以轻松控制日期的时区。例如，{{$date.now|format('yyyy-MM-dd HH:mm:ss',timezone='America/Port-au-Prince')}} 将返回 UTC+8:00 时区中当前时间对应的日期。

常见动态值#