# Group and project access requests API > 原文：[https://docs.gitlab.com/ee/api/access_requests.html](https://docs.gitlab.com/ee/api/access_requests.html) * [Valid access levels](#valid-access-levels) * [List access requests for a group or project](#list-access-requests-for-a-group-or-project) * [Request access to a group or project](#request-access-to-a-group-or-project) * [Approve an access request](#approve-an-access-request) * [Deny an access request](#deny-an-access-request) # Group and project access requests API[](#group-and-project-access-requests-api "Permalink") **注意：**此功能是在 GitLab 8.11 中引入的 ## Valid access levels[](#valid-access-levels "Permalink") 訪問級別在`Gitlab::Access`模塊中定義. 當前，這些級別被認可： * 無法訪問（ `0` ） * 賓客（ `10` ） * 記者（ `20` ） * 顯影劑（ `30` ） * 養護者（ `40` ） * 所有者（ `50` ）-僅對組有效 ## List access requests for a group or project[](#list-access-requests-for-a-group-or-project "Permalink") 獲取認證用戶可見的訪問請求列表. ``` GET /groups/:id/access_requests GET /projects/:id/access_requests ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | 請求示例： ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/access_requests" curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/access_requests" ``` 響應示例： ``` [ { "id": 1, "username": "raymond_smith", "name": "Raymond Smith", "state": "active", "created_at": "2012-10-22T14:13:35Z", "requested_at": "2012-10-22T14:13:35Z" }, { "id": 2, "username": "john_doe", "name": "John Doe", "state": "active", "created_at": "2012-10-22T14:13:35Z", "requested_at": "2012-10-22T14:13:35Z" } ] ``` ## Request access to a group or project[](#request-access-to-a-group-or-project "Permalink") 請求已驗證用戶訪問組或項目. ``` POST /groups/:id/access_requests POST /projects/:id/access_requests ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | 請求示例： ``` curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/access_requests" curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/access_requests" ``` 響應示例： ``` { "id": 1, "username": "raymond_smith", "name": "Raymond Smith", "state": "active", "created_at": "2012-10-22T14:13:35Z", "requested_at": "2012-10-22T14:13:35Z" } ``` ## Approve an access request[](#approve-an-access-request "Permalink") 批準給定用戶的訪問請求. ``` PUT /groups/:id/access_requests/:user_id/approve PUT /projects/:id/access_requests/:user_id/approve ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | | `user_id` | integer | yes | 訪問請求者的用戶標識 | | `access_level` | integer | no | 有效的訪問級別（默認值： `30` ，開發人員訪問級別） | 請求示例： ``` curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/access_requests/:user_id/approve?access_level=20" curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/access_requests/:user_id/approve?access_level=20" ``` 響應示例： ``` { "id": 1, "username": "raymond_smith", "name": "Raymond Smith", "state": "active", "created_at": "2012-10-22T14:13:35Z", "access_level": 20 } ``` ## Deny an access request[](#deny-an-access-request "Permalink") 拒絕給定用戶的訪問請求. ``` DELETE /groups/:id/access_requests/:user_id DELETE /projects/:id/access_requests/:user_id ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | | `user_id` | integer | yes | 訪問請求者的用戶標識 | 請求示例： ``` curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/:id/access_requests/:user_id" curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/:id/access_requests/:user_id" ```