# API 文档问题

**URL:** https://meta.discourse.org/t/api-documentation-issue/133707
**Category:** Development
**Created:** [2019年十一月18日 17:06 UTC](https://meta.discourse.org/t/api-documentation-issue/133707 "2019-11-18T17:06:42Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![Grayden\_Shand](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/grayden_shand/32/166586_2.png) [@Grayden\_Shand](https://meta.discourse.org/u/Grayden_Shand)
#### Post date: [2019年十一月18日 17:06 UTC](https://meta.discourse.org/t/api-documentation-issue/133707/1 "2019-11-18T17:06:42Z")

</div>

在 API 文档中发现了一个问题，具体是“更新群组”端点（[Discourse API Docs](https://docs.discourse.org/#tag/Groups/paths/~1groups~1%7Bname%7D.json/put%EF%BC%89)

文档指出应使用群组的名称来构建端点，例如：  
`PUT https://discourse.example.com/groups/{name}.json`

该端点适用于 GET 请求，但在执行 PUT 请求时返回 404 错误。

当我逆向分析 UI 时，发现实际使用的端点包含的是群组 ID，而非群组名称。  
`PUT https://discourse.example.com/groups/{id}`

调用此端点时请求成功。因此，我建议更新文档中的端点描述。

---

<div class="post-metadata">

### Author: ![blake](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/blake/32/157322_2.png) [@blake](https://meta.discourse.org/u/blake)
#### Post date: [2019年十一月20日 22:08 UTC](https://meta.discourse.org/t/api-documentation-issue/133707/3 "2019-11-20T22:08:26Z")

</div>

感谢您提出这个问题。我已在 API 文档中更新了该端点。

---

<div class="post-metadata">

### Author: ![blake](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/blake/32/157322_2.png) [@blake](https://meta.discourse.org/u/blake)
#### Post date: [2019年十一月20日 22:08 UTC](https://meta.discourse.org/t/api-documentation-issue/133707/4 "2019-11-20T22:08:42Z")

</div>