参数映射

插件信息

名称字段属性
参数映射params_transformer参数处理

功能描述

实现表单或json参数的映射,访问API的 参数A 绑定到目标API的 参数B,映射位置包括header、body、query。

注意事项:

  • 若访问API的参数名是user,目标API的参数名是username,此时需开启参数映射插件;若均为username,则无需开启此插件。
  • json仅支持 一级 映射。
  • 若参数类型为表单时,映射插件支持同名参数的使用。
  • 使用该插件时请保证Content-Type为 application/x-www-form-urlencoded、 multipart/form-data 或 application/json。

配置参数说明

参数名值类型是否必填值可能性默认值说明
paramsarray_object映射参数列表
params -> namestring待映射参数名称
params -> positionstring["body","header","query"]待映射参数所在位置
params -> proxy_namestring目标参数名称
params -> proxy_positionstring目标参数所在位置
params -> requiredboolfalsefalse待映射参数是否必含,如为true,该参数不存在时会报错
removeboolfalsefalse映射后删除原参数
error_typestring["text","json"]text插件返回报错的类型

全局开启该插件

配置带有参数映射插件的服务