Power Apps连接自定义连接器遇collectionFormat(Multi)不支持错误，求替代方案

问题说明 #

在Power Apps中尝试连接自定义连接器时，针对可分页对象出现报错，根源是API规范中的sort对象。当前必须使用OpenApi2（Swagger API），遇到的具体Swagger验证错误翻译后如下：

定义无效。错误：'错误：paths/_1api1v3~random-api-dates/get/parameters/9/collectionFormat：不支持'collectionFormat'关键字的值'Multi'。## 错误：'

替代解决方案 #

1. 替换不支持的collectionFormat值 #

Power Apps自定义连接器对OpenApi2的collectionFormat支持有限，不认可multi值，可替换为以下两种官方支持的格式：

• csv格式：参数值用逗号分隔传递，配置示例：

  parameters:
    - name: sort
      in: query
      type: array
      items:
        type: string
      collectionFormat: csv
  

• ssv格式：参数值用空格分隔传递，配置示例：

  parameters:
    - name: sort
      in: query
      type: array
      items:
        type: string
      collectionFormat: ssv
  

2. 手动定义多实例参数 #

如果API本身要求同一个参数名重复传递（如sort=field1&sort=field2，和collectionFormat: multi效果一致），可以直接将sort定义为允许重复的单值参数，而非数组类型：

parameters:
  - name: sort
    in: query
    type: string
    required: false
    allowEmptyValue: true
    allowMultiple: true

通过allowMultiple: true配置，Power Apps会允许该参数多次传入，实现目标效果。

3. 调整后端API适配规则 #

如果上述前端配置方案无法满足需求，可修改后端API的参数接收逻辑，兼容Power Apps支持的csv或ssv格式，在API内部将分隔后的字符串解析为排序字段数组。

内容的提问来源于stack exchange，提问作者Vipul Jain