tokers commented on a change in pull request #4016:
URL: https://github.com/apache/apisix/pull/4016#discussion_r611145081
##########
File path: docs/en/latest/admin-api.md
##########
@@ -94,7 +94,10 @@ Note: When the `Admin API` is enabled, it will occupy the
API prefixed with `/ap
| create_time | False | Auxiliary |
epoch timestamp in second, will be created automatically if missing
| 1602883670 |
| update_time | False | Auxiliary |
epoch timestamp in second, will be created automatically if missing
| 1602883670 |
-For the same type of parameters, such as `host` and `hosts`, `remote_addr` and
`remote_addrs` cannot exist at the same time, only one of them can be selected.
If enabled at the same time, the API will respond with an error.
+There are two points that need special attention:
+
+- For the same type of parameters, such as `host` and `hosts`, `remote_addr`
and `remote_addrs` cannot exist at the same time, only one of them can be
selected. If enabled at the same time, the API will respond with an error.
+- In `vars`, when getting the cookie value, the cookie name is case-sensitive.
For example: `var` equals "cookie_x_foo" and `var` equals "cookie_X_Foo" means
different `cookie`.
Review comment:
```suggestion
- In `vars`, when getting the cookie value, the cookie name is
**case-sensitive**. For example: `var` equals "cookie_x_foo" and `var` equals
"cookie_X_Foo" means different `cookie`.
```
##########
File path: docs/zh/latest/admin-api.md
##########
@@ -558,7 +558,7 @@ APISIX 的 Upstream 除了基本的复杂均衡算法选择外,还支持对上
1. 设为 `vars` 时,`key` 为必传参数,目前支持的 Nginx 内置变量有 `uri, server_name, server_addr,
request_uri, remote_port, remote_addr, query_string, host, hostname,
arg_***`,其中 `arg_***` 是来自 URL 的请求参数,[Nginx
变量列表](http://nginx.org/en/docs/varindex.html)
2. 设为 `header` 时, `key` 为必传参数,其值为自定义的 header name, 即 "http\_`key`"
-3. 设为 `cookie` 时, `key` 为必传参数,其值为自定义的 cookie name,即 "cookie\_`key`"
+3. 设为 `cookie` 时, `key` 为必传参数,其值为自定义的 cookie name,即 "cookie\_`key`"。请注意 cookie
name 是区分大小写字母的。例如:"cookie_x_foo" 与 "cookie_X_Foo" 表示不同的 `cookie`。
Review comment:
```suggestion
3. 设为 `cookie` 时, `key` 为必传参数,其值为自定义的 cookie name,即 "cookie\_`key`"。请注意
cookie name 是**区分大小写字母**的。例如:"cookie_x_foo" 与 "cookie_X_Foo" 表示不同的 `cookie`。
```
--
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.
For queries about this service, please contact Infrastructure at:
[email protected]