Issues Statistics API · Gitlab 中文文檔

# Issues Statistics API > 原文：[https://docs.gitlab.com/ee/api/issues_statistics.html](https://docs.gitlab.com/ee/api/issues_statistics.html) * [Get issues statistics](#get-issues-statistics) * [Get group issues statistics](#get-group-issues-statistics) * [Get project issues statistics](#get-project-issues-statistics) # Issues Statistics API[](#issues-statistics-api "Permalink") 每個對 issue_statistics 的 API 調用都必須經過身份驗證. 如果用戶不是項目成員，并且該項目是私有項目，則對該項目的`GET`請求將導致`404`狀態代碼. ## Get issues statistics[](#get-issues-statistics "Permalink") 獲取有關經過身份驗證的用戶有權訪問的所有問題的問題計數統計信息. 默認情況下，它僅返回當前用戶創建的問題. 要獲取所有問題，請使用參數`scope=all` . ``` GET /issues_statistics GET /issues_statistics?labels=foo GET /issues_statistics?labels=foo,bar GET /issues_statistics?labels=foo,bar&state=opened GET /issues_statistics?milestone=1.0.0 GET /issues_statistics?milestone=1.0.0&state=opened GET /issues_statistics?iids[]=42&iids[]=43 GET /issues_statistics?author_id=5 GET /issues_statistics?assignee_id=5 GET /issues_statistics?my_reaction_emoji=star GET /issues_statistics?search=foo&in=title GET /issues_statistics?confidential=true ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `labels` | string | no | 標簽名稱的逗號分隔列表，必須具有要返回的所有標簽的問題. `None`列出所有沒有標簽的問題. `Any`列出至少帶有一個標簽的所有問題. | | `milestone` | string | no | 里程碑標題. `None`列出沒有里程碑的所有問題. `Any`列出具有指定里程碑的所有問題. | | `scope` | string | no | 回到問題在給定范圍： `created_by_me` ， `assigned_to_me`或`all` . 默認為`created_by_me` | | `author_id` | integer | no | 返回由給定用戶`id`創建的問題. 與`author_username` . 與`scope=all`或`scope=assigned_to_me`結合使用. | | `author_username` | string | no | 返回由給定`username`創建的問題. 類似于`author_id`并且與`author_id` . | | `assignee_id` | integer | no | Return issues assigned to the given user `id`. Mutually exclusive with `assignee_username`. `None` returns unassigned issues. `Any` returns issues with an assignee. | | `assignee_username` | 字符串數組 | no | 返回分配給給定`username` . 類似于`assignee_id`并且與`assignee_id`互斥. 在 GitLab CE 中， `assignee_username`數組應僅包含單個值，否則將返回無效的參數錯誤. | | `my_reaction_emoji` | string | no | 返回的問題由已驗證的用戶通過給定的`emoji`響應. `None`返回沒有響應的問題. 至少有一個反應， `Any`回報問題. | | `iids[]` | 整數數組 | no | 僅返回具有給定`iid`的問題 | | `search` | string | no | 根據`title`和`description`搜索問題 | | `in` | string | no | 修改`search`屬性的范圍. `title` ， `description`或以逗號將它們連接在一起的字符串. 默認為`title,description` | | `created_after` | datetime | no | 返回在給定時間或之后創建的問題 | | `created_before` | datetime | no | 返回在給定時間或之前創建的問題 | | `updated_after` | datetime | no | 返回在給定時間或之后更新的問題 | | `updated_before` | datetime | no | 返回在給定時間或之前更新的問題 | | `confidential` | boolean | no | 過濾機密或公共問題. | ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/issues_statistics" ``` 響應示例： ``` { "statistics": { "counts": { "all": 20, "closed": 5, "opened": 15 } } } ``` ## Get group issues statistics[](#get-group-issues-statistics "Permalink") 獲取給定組的問題計數統計信息. ``` GET /groups/:id/issues_statistics GET /groups/:id/issues_statistics?labels=foo GET /groups/:id/issues_statistics?labels=foo,bar GET /groups/:id/issues_statistics?labels=foo,bar&state=opened GET /groups/:id/issues_statistics?milestone=1.0.0 GET /groups/:id/issues_statistics?milestone=1.0.0&state=opened GET /groups/:id/issues_statistics?iids[]=42&iids[]=43 GET /groups/:id/issues_statistics?search=issue+title+or+description GET /groups/:id/issues_statistics?author_id=5 GET /groups/:id/issues_statistics?assignee_id=5 GET /groups/:id/issues_statistics?my_reaction_emoji=star GET /groups/:id/issues_statistics?confidential=true ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 認證用戶擁有[的組](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | | `labels` | string | no | 標簽名稱的逗號分隔列表，必須具有要返回的所有標簽的問題. `None`列出所有沒有標簽的問題. `Any`列出至少帶有一個標簽的所有問題. | | `iids[]` | 整數數組 | no | 僅返回具有給定`iid`的問題 | | `milestone` | string | no | 里程碑標題. `None`列出沒有里程碑的所有問題. `Any`列出具有指定里程碑的所有問題. | | `scope` | string | no | 回到問題在給定范圍： `created_by_me` ， `assigned_to_me`或`all` . | | `author_id` | integer | no | 返回由給定用戶`id`創建的問題. 與`author_username` . 與`scope=all`或`scope=assigned_to_me`結合使用. | | `author_username` | string | no | 返回由給定`username`創建的問題. 類似于`author_id`并且與`author_id` . | | `assignee_id` | integer | no | 返回分配給給定用戶`id` . 互斥與`assignee_username` . `None`返回未分配的問題. 受讓人有`Any`退貨問題. | | `assignee_username` | 字符串數組 | no | 返回分配給給定`username` . 類似于`assignee_id`并且與`assignee_id`互斥. 在 GitLab CE 中， `assignee_username`數組應僅包含單個值，否則將返回無效的參數錯誤. | | `my_reaction_emoji` | string | no | 返回的問題由已驗證的用戶通過給定的`emoji`響應. `None`返回沒有響應的問題. 至少有一個反應， `Any`回報問題. | | `search` | string | no | 搜索組問題的`title`和`description` | | `created_after` | datetime | no | 返回在給定時間或之后創建的問題 | | `created_before` | datetime | no | 返回在給定時間或之前創建的問題 | | `updated_after` | datetime | no | 返回在給定時間或之后更新的問題 | | `updated_before` | datetime | no | 返回在給定時間或之前更新的問題 | | `confidential` | boolean | no | 過濾機密或公共問題. | ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/4/issues_statistics" ``` 響應示例： ``` { "statistics": { "counts": { "all": 20, "closed": 5, "opened": 15 } } } ``` ## Get project issues statistics[](#get-project-issues-statistics "Permalink") 獲取給定項目的問題計數統計信息. ``` GET /projects/:id/issues_statistics GET /projects/:id/issues_statistics?labels=foo GET /projects/:id/issues_statistics?labels=foo,bar GET /projects/:id/issues_statistics?labels=foo,bar&state=opened GET /projects/:id/issues_statistics?milestone=1.0.0 GET /projects/:id/issues_statistics?milestone=1.0.0&state=opened GET /projects/:id/issues_statistics?iids[]=42&iids[]=43 GET /projects/:id/issues_statistics?search=issue+title+or+description GET /projects/:id/issues_statistics?author_id=5 GET /projects/:id/issues_statistics?assignee_id=5 GET /projects/:id/issues_statistics?my_reaction_emoji=star GET /projects/:id/issues_statistics?confidential=true ``` | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 經過身份驗證的用戶擁有[的項目](README.html#namespaced-path-encoding)的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) | | `iids[]` | 整數數組 | no | 僅返回具有給定`iid`的里程碑 | | `labels` | string | no | 標簽名稱的逗號分隔列表，必須具有要返回的所有標簽的問題. `None`列出所有沒有標簽的問題. `Any`列出至少帶有一個標簽的所有問題. | | `milestone` | string | no | 里程碑標題. `None`列出沒有里程碑的所有問題. `Any`列出具有指定里程碑的所有問題. | | `scope` | string | no | 回到問題在給定范圍： `created_by_me` ， `assigned_to_me`或`all` . | | `author_id` | integer | no | 返回由給定用戶`id`創建的問題. 與`author_username` . 與`scope=all`或`scope=assigned_to_me`結合使用. | | `author_username` | string | no | 返回由給定`username`創建的問題. 類似于`author_id`并且與`author_id` . | | `assignee_id` | integer | no | 返回分配給給定用戶`id` . 互斥與`assignee_username` . `None`返回未分配的問題. 受讓人有`Any`退貨問題. | | `assignee_username` | 字符串數組 | no | 返回分配給給定`username` . 類似于`assignee_id`并且與`assignee_id`互斥. 在 GitLab CE 中， `assignee_username`數組應僅包含單個值，否則將返回無效的參數錯誤. | | `my_reaction_emoji` | string | no | 返回的問題由已驗證的用戶通過給定的`emoji`響應. `None`返回沒有響應的問題. 至少有一個反應， `Any`回報問題. | | `search` | string | no | 根據`title`和`description`搜索項目問題 | | `created_after` | datetime | no | Return issues created on or after the given time | | `created_before` | datetime | no | 返回在給定時間或之前創建的問題 | | `updated_after` | datetime | no | 返回在給定時間或之后更新的問題 | | `updated_before` | datetime | no | 返回在給定時間或之前更新的問題 | | `confidential` | boolean | no | 過濾機密或公共問題. | ``` curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/4/issues_statistics" ``` 響應示例： ``` { "statistics": { "counts": { "all": 20, "closed": 5, "opened": 15 } } } ```