Shopware 6搜索条件应POST至哪个端点？相关技术咨询

问题 #

在Shopware 6中，官方文档提到搜索条件端点使用POST方法接收JSON格式搜索条件，但产品资源基础信息列表的GET端点忽略了limit、includes等参数。具体尝试的GET请求如下：

http://shopware65.local/api/product?query=%7B%22limit%22%3A10%2C%22associations%22%3A%7B%22manufacturer%22%3A%5B%5D%7D%2C%22includes%22%3A%7B%22product%22%3A%5B%22calculatedPrice%22%2C%22cover%22%2C%22id%22%2C%22manufacturer%22%2C%22ean%22%5D%2C%22product_media%22%3A%5B%22media%22%5D%7D%7D

解码后的query参数JSON内容：

{"limit":10,"associations":{"manufacturer":[]},"includes":{"product":["calculatedPrice","cover","id","manufacturer","ean"],"product_media":["media"]}}

现咨询：

1. 用于读取数据的POST搜索条件端点是什么？
2. 该内容是否与SwagQL库有关？
3. 是否需要搭建SwagQL服务器？

解答 #

1. POST搜索条件端点 #

Shopware 6 Admin API中，用于读取数据的POST搜索端点格式为/api/search/{entity}，对应产品的端点就是/api/search/product。
你需要把搜索条件以JSON格式放在请求体中发送，示例请求体如下：

{
  "limit": 10,
  "associations": {
    "manufacturer": []
  },
  "includes": {
    "product": ["calculatedPrice", "cover", "id", "manufacturer", "ean"],
    "product_media": ["media"]
  }
}

这个端点会正确解析你设置的所有搜索条件，不会像GET请求那样出现参数被忽略的情况。

2. 与SwagQL的关系 #

SwagQL是Shopware的GraphQL相关工具，但你提到的POST搜索条件端点属于Shopware原生的Admin REST API功能，和SwagQL没有直接关联，无需依赖该库即可使用。

3. 是否需要搭建SwagQL服务器 #

不需要。/api/search/{entity}这类REST搜索端点是Shopware自带的Admin API功能，直接使用现有Shopware服务即可，无需额外搭建SwagQL服务器。

内容的提问来源于stack exchange，提问作者Daniel W.