如何使用cli-jsonInput？注意事项有哪些？

问题背景

命令提示符（cmd.exe）等工具对使用时输入的字符串的最大长度有限制。当需要执行的命令的参数过多或参数值过长时，可能会因为其长度限制导致命令输入不完整。因此KooCLI除了支持参数在命令中直接输入之外，也支持使用“--cli-jsonInput=${jsonFileName}”传入JSON文件，向KooCLI传递云服务API参数。KooCLI会在运行时解析并使用该JSON文件中的参数调用目标API。

使用方式

cli-jsonInput的使用方式请参考：以JSON文件的方式传递API参数。

注意事项

• “--cli-jsonInput”选项传入的JSON文件中目前只支持写入云服务的API参数，不支持写入系统参数。若目标API中存在与新系统参数或旧系统参数重名的参数，被写入jsonInput文件中的默认将被识别为该API的参数；
• “--cli-jsonInput”选项传入的JSON文件中，KooCLI会根据JSON最外层的Key获取并解析其的参数值，目前支持的Key包括：path、query、body、formData、header、cookie。JSON最外层的其他Key下的内容将会被忽略。若JSON文件里所有最外层的Key都不属于上述支持的Key之一，会提示如下错误：

  [USE_ERROR]cli-jsonInput文件内容不符合要求,详情请参考...

• 使用“--cli-jsonInput”选项传入云服务API参数时，同一位置的API参数必须全部写入JSON文件，或全部通过命令直接传入，否则可能会导致参数解析不完整，会提示如下错误：

  [USE_ERROR]缺少必填参数:*

• “--cli-jsonInput”选项只支持传入JSON格式的文件，且文件扩展名必须为“.json”，支持传入的最大文件为5MB；使用“--cli-jsonInput”时，会校验JSON文件的格式及文件中参数的类型。若JSON文件的格式有误，会提示：

  [USE_ERROR]cli-jsonInput参数的文件解析失败,文件中参数有误

  若JSON文件中某参数的类型不被支持，会提示：

  [USE_ERROR]不支持参数*的值的类型

• 使用“--cli-jsonInput”选项传入云服务API参数时，参数的取值不支持使用custom参数。