SylviaBABY commented on code in PR #6886: URL: https://github.com/apache/apisix/pull/6886#discussion_r853648631
########## docs/zh/latest/plugins/batch-requests.md: ########## @@ -23,92 +28,107 @@ title: batch-requests ## 描述 -`batch-requests` 插件可以一次接受多个请求并以 [http pipeline](https://en.wikipedia.org/wiki/HTTP_pipelining) 的方式在网关发起多个 http 请求，合并结果后再返回客户端，这在客户端需要访问多个接口时可以显著地提升请求性能。 +`batch-requests` 插件可以一次接受多个请求并以 [HTTP pipeline](https://en.wikipedia.org/wiki/HTTP_pipelining) 的方式在网关发起多个 HTTP 请求，合并结果后再返回客户端。 -> **提示** -> -> 外层的 Http 请求头会自动设置到每一个独立请求中，如果独立请求中出现相同键值的请求头，那么只有独立请求的请求头会生效。 +在客户端需要访问多个 API 的情况下，这将显著提高性能。 + +:::note + +外部批处理请求的 HTTP 请求头（除了以 `Content-` 开始的请求头，例如：`Content-Type`）适用于**批处理**中的每个请求。 + +如果在外部请求和单个调用中都指定了相同的 HTTP 请求头，则单个调用的请求头优先。 + +::: ## 属性 无 ## 接口 -插件会增加 `/apisix/batch-requests` 这个接口，需要通过 [public-api](../../../en/latest/plugins/public-api.md) 插件来暴露它。 +该插件会增加 `/apisix/batch-requests` 接口。 -## 如何启用 +:::note -你需要在 `config.yaml` 里面启用 batch-requests 插件： +你需要通过 [public-api](../../../zh/latest/plugins/public-api.md) 插件来暴露它。 -``` -# 加到 config.yaml +::: + +## 启用插件 + +该插件默认是禁用状态，你可以配置文件（`./conf/config.yaml`）添加如下配置启用 `batch-requests` 插件： Review Comment: ```suggestion 该插件默认为禁用状态，你可以在配置文件（`./conf/config.yaml`）中添加如下配置来启用 `batch-requests` 插件： ``` -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
