POP产品白皮书

POP可以将用户传递的参数转换为后端需要的格式及对参数的简单验证;也可将业务方返回的参数转换,使接入方的参数名和字段值不暴露给用户,也让用户更易识别。 具体配置方法可参照:入参描述、返回参数描述。

  1.  入参、出参名称映射 可以配置后端参数名称和展示名间映射关系;使用name和tagName分别表示后端参数名称和展示名称。
  2.  入参、出参值映射 可以隐藏后端参数值,转换为展示名。可以使用Switch进行遍历匹配。
  3.  默认值配置 对于非必填参数可以设置默认值,使用default=””表示,用户不填写此参数时,默认补齐。
  4.  枚举值校验 可以配置入参枚举;使用value=”1,2,3”配置。若用户传递值不在枚举范围内,则会直接返回错误:Invalid{ParameterName},不会将请求转至后端。
  5.  必填项校验 可对进行必填性校验,可配置required中的true、false表示;若用户不传必填参数,则直接返回错误:Missing{ParameterName},不会将请求转至后端。
  6.  数值类型入参取值范围校验 可对数值型参数设置取值范围,可以配置:minValue、maxValue;当用户传值不在取值范围内时,则会直接返回错误:Invalid{ParameterName},不会将请求转至后端。