OpenRemote HTTP API按资产名称查询的请求格式问题咨询

我尝试用OpenRemote的HTTP API按资产名称搜索资产。已知资产ID时，直接发送GET请求到路径/asset/THE_ASSET_ID即可，但按名称查询需要向/asset/query发送POST请求。

Swagger文档展示的JSON请求结构过于庞大，多数字段并非必填。我发送了极简请求体：

{  
  "types": [ "ThingAsset" ],  
  "names": [    
    {      
      "value": "the name to find"    
    }  
  ]
}

却收到HTTP 500内部服务器错误，日志显示缺少predicateType参数，但我使用的JSON中并无该参数。

names字段的JSON结构如下：

"names": [    
    {      
      "match": "string",      
      "caseSensitive": true,      
      "value": "string",      
      "negate": true    
    }  
  ],

我无法找到这些JSON元素的说明，例如“string”对应的具体内容，也不确定是否需要同时提供match和value。我推测match是正则表达式、value是静态字符串，或是match取值为static或regexp，value为对应值，但缺乏明确定义。

我查看了queryAssets的实现代码，其中未提及RequestParams对象，推测JSON内容会传入AssetQuery对象，但深入研究成本较高。

想问下有没有使用OpenRemote RESTful API的经验？有没有文档说明/asset/query请求的必填项，尤其是按名称查询的情况？

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