Update zh tw languages and fix some broken links (#455)

---------

Co-authored-by: silverwind <me@silverwind.io>
Co-authored-by: silverwind <2021+silverwind@noreply.gitea.com>
Reviewed-on: https://gitea.com/gitea/docs/pulls/455
Reviewed-by: silverwind <2021+silverwind@noreply.gitea.com>
This commit is contained in:
Lunny Xiao
2026-07-09 23:41:46 +00:00
parent c0f8a04185
commit 965c269495
652 changed files with 30864 additions and 30792 deletions

View File

@@ -8,10 +8,12 @@ aliases:
# API 使用
## 啟用/配置 API 訪問
## 啟用/設定 API 存取
預設情況下,`ENABLE_SWAGGER` 是啟用的,`MAX_RESPONSE_ITEMS` 設定為 50。更多資訊請參閱 [配置速查表](../administration/config-cheat-sheet.md)。
預設情況下,`ENABLE_SWAGGER` 是啟用的,`MAX_RESPONSE_ITEMS` 設定為 50。更多資訊請參閱 [設定速查表](../administration/config-cheat-sheet.md)。
<a id="authentication"></a>
<a id="通過-api-認證"></a>
## 認證
Gitea 支援以下 API 認證方法:
@@ -21,11 +23,11 @@ Gitea 支援以下 API 認證方法:
- URL 查詢字串中的 `access_token=...` 參數
- HTTP 標頭中的 `Authorization: token ...` 標頭
所有這些方法都接受相同的 API 金鑰令牌類型。你可以過查看碼更好地理解這一點——截至撰寫本文時Gitea 會解析查詢和標頭以找到令牌,詳見 [modules/auth/auth.go](https://github.com/go-gitea/gitea/blob/6efdcaed86565c91a3dc77631372a9cc45a58e89/modules/auth/auth.go#L47)。
所有這些方法都接受相同的 API 金鑰令牌類型。你可以過查看程式碼更好地理解這一點——截至撰寫本文時Gitea 會解析查詢和標頭以找到令牌,詳見 [modules/auth/auth.go](https://github.com/go-gitea/gitea/blob/6efdcaed86565c91a3dc77631372a9cc45a58e89/modules/auth/auth.go#L47)。
## 生成和列出 API 令牌
可以過向 `/users/:name/tokens` 發送 `POST` 請求來生成新令牌。
可以過向 `/users/:name/tokens` 發送 `POST` 請求來生成新令牌。
請注意,`/users/:name/tokens` 是一個特殊端點,需要使用 `BasicAuth` 和密碼進行認證,如下所示:
@@ -34,24 +36,25 @@ $ curl -H "Content-Type: application/json" -d '{"name":"test"}' -u username:pass
{"id":1,"name":"test","sha1":"9fcb1158165773dd010fca5f0cf7174316c3e37d","token_last_eight":"16c3e37d"}
```
`sha1`(令牌)只會返回一次,並且不會以明文形式儲。當使用 `GET` 請求列出令牌時,它不會顯示;例如:
`sha1`(令牌)只會返回一次,並且不會以明文形式儲。當使用 `GET` 請求列出令牌時,它不會顯示;例如:
```sh
$ curl --url https://yourusername:password@gitea.your.host/api/v1/users/<username>/tokens
[{"name":"test","sha1":"","token_last_eight:"........":},{"name":"dev","sha1":"","token_last_eight":"........"}]
```
要在啟用雙因素認證的情況下使用基本認證 API你需要發送一個包含一次性密碼6 位數旋轉令牌)的額外標頭。標頭例如 `X-Gitea-OTP: 123456`,其中 `123456` 是你從身份驗證器中獲取的碼。以下是 curl 請求的例:
要在啟用雙因素認證的情況下使用基本認證 API你需要發送一個包含一次性密碼6 位數旋轉令牌)的額外標頭。標頭例如 `X-Gitea-OTP: 123456`,其中 `123456` 是你從身份驗證器中獲取的程式碼。以下是 curl 請求的例:
```sh
$ curl -H "X-Gitea-OTP: 123456" --url https://yourusername:yourpassword@gitea.your.host/api/v1/users/yourusername/tokens
```
你也可以過 Gitea 安裝的網頁界面創建 API 金鑰令牌:`Settings | Applications | Generate New Token`
你也可以過 Gitea 安裝的網頁介面建立 API 金鑰令牌:`Settings | Applications | Generate New Token`
<a id="oauth2-provider"></a>
## OAuth2 提供者
從 Gitea 的 [OAuth2 提供者](development/oauth2-provider.md) 獲取的訪問令牌可以過以下方法接受:
從 Gitea 的 [OAuth2 提供者](development/oauth2-provider.md) 獲取的存取權杖可以過以下方法接受:
- HTTP 標頭中的 `Authorization bearer ...` 標頭
- URL 查詢字串中的 `token=...` 參數
@@ -78,7 +81,7 @@ curl "http://localhost:4000/api/v1/repos/test1/test1/issues" \
## 分頁
API 支援分頁。`page``limit` 參數用於指定頁碼和每頁的項目數量。如果有多頁,則返回 `Link` 標頭,其中包含下一頁、上一頁和最後一頁的鏈接。還返回 `x-total-count` 以指示項目總數。
API 支援分頁。`page``limit` 參數用於指定頁碼和每頁的專案數量。如果有多頁,則返回 `Link` 標頭,其中包含下一頁、上一頁和最後一頁的鏈接。還返回 `x-total-count` 以指示專案總數。
```sh
curl -v "http://localhost/api/v1/repos/search?limit=1"
@@ -100,7 +103,7 @@ OpenAPI 文件位於:
## Sudo
API 允許管理員用戶以其他用戶的身份 sudo API 請求。只需添加 `sudo=` 參數或 `Sudo:` 請求標頭,並附上要 sudo 的用戶名
API 允許管理員使用者以其他使用者的身份 sudo API 請求。只需添加 `sudo=` 參數或 `Sudo:` 請求標頭,並附上要 sudo 的使用者名稱
## SDKs