이슈 통계 API
Tier: Free, Premium, Ultimate
Offering: GitLab.com, Self-managed, GitLab Dedicated
이슈 통계 API로의 모든 API 호출은 인증되어야 합니다.
만약 사용자가 프로젝트의 구성원이 아니고 해당 프로젝트가 비공개인 경우, 해당 프로젝트에 대한 GET
요청은 404
상태 코드를 반환합니다.
이슈 통계 가져오기
인증된 사용자가 접근할 수 있는 모든 이슈에 대한 이슈 수 통계를 가져옵니다. 기본적으로 현재 사용자가 만든 이슈만 반환됩니다. 모든 이슈를 얻으려면 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
속성 | 타입 | 필수여부 | 설명 |
---|---|---|---|
labels
| string | 아니오 | 레이블 이름의 쉼표로 구분된 목록. 이슈에 모든 레이블이 있어야합니다. None 은 레이블이없는 모든 이슈 목록입니다. Any 는 적어도 하나의 레이블이있는 모든 이슈를 목록화합니다.
|
milestone
| string | 아니오 | 마일스톤 제목. None 은 마일스톤이없는 모든 이슈 목록입니다. Any 는 지정된 마일스톤이있는 모든 이슈를 목록화합니다.
|
scope
| string | 아니오 | 주어진 범위에 대한 이슈를 반환합니다. created_by_me , assigned_to_me 또는 all . 기본값은 created_by_me
|
author_id
| integer | 아니오 | 주어진 사용자 id 가 만든 이슈를 반환합니다. author_username 과 상호 배타적입니다. scope=all 또는 scope=assigned_to_me 과 함께 사용합니다.
|
author_username
| string | 아니오 | 주어진 username 이 만든 이슈를 반환합니다. author_id 와 유사하며 상호 배타적입니다.
|
assignee_id
| integer | 아니오 | 주어진 사용자 id 에 할당된 이슈를 반환합니다. assignee_username 과 상호 배타적입니다. None 은 할당되지 않은 이슈를 반환합니다.Any 는 담당자가있는 이슈를 반환합니다.
|
assignee_username
| string array | 아니오 | 주어진 username 에 할당된 이슈를 반환합니다. assignee_id 와 유사하며 상호 배타적입니다. GitLab CE에서 assignee_username 배열은 단일 값이거나 그렇지 않으면 잘못된 매개 변수 오류가 반환됩니다.
|
epic_id
| integer | 아니오 | 주어진 epic ID와 관련된 이슈를 반환합니다. None 은 epic과 관련이없는 issue를 반환합니다.Any 는 epic과 관련된 issue를 반환합니다. 프리미엄 및 얼티메이트 전용입니다.
|
my_reaction_emoji
| string | 아니오 | 특정 이모지 로 인증된 사용자가 반응한 이슈를 반환합니다. None 은 반응이없는 이슈를 반환합니다. Any 는 적어도 하나의 반응이있는 이슈를 반환합니다.
|
iids[]
| integer array | 아니오 | 주어진 iid 를 가진 이슈만 반환합니다
|
search
| string | 아니오 | 이슈를 title 및 description 에 대해 검색합니다
|
in
| string | 아니오 |
search 속성의 범위를 수정합니다. title 및 description 또는 쉼표로 연결된 문자열. 기본값은 title,description
|
created_after
| datetime | 아니오 | 주어진 시간 이후에 생성된 이슈를 반환합니다. ISO 8601 형식 예상 (2019-03-15T08:00:00Z )
|
created_before
| datetime | 아니오 | 주어진 시간 이전에 생성된 이슈를 반환합니다. ISO 8601 형식 예상 (2019-03-15T08:00:00Z )
|
updated_after
| datetime | 아니오 | 주어진 시간 이후에 업데이트된 이슈를 반환합니다. ISO 8601 형식 예상 (2019-03-15T08:00:00Z )
|
updated_before
| datetime | 아니오 | 주어진 시간 이전에 업데이트된 이슈를 반환합니다. ISO 8601 형식 예상 (2019-03-15T08:00:00Z )
|
confidential
| boolean | 아니오 | 기밀 또는 공개 이슈를 필터링합니다. |
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/issues_statistics"
예시 응답:
{
"statistics": {
"counts": {
"all": 20,
"closed": 5,
"opened": 15
}
}
}
그룹 이슈 통계 가져오기
주어진 그룹에 대한 이슈 수 통계를 가져옵니다.
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
속성 | 타입 | 필수여부 | 설명 |
---|---|---|---|
id
| integer/string | 예 | 그룹의 ID 또는 URL 인코딩된 경로 |
labels
| string | 아니오 | 레이블 이름의 쉼표로 구분된 목록. 이슈에 모든 레이블이 있어야합니다. None 은 레이블이없는 모든 이슈 목록입니다. Any 는 적어도 하나의 레이블이있는 모든 이슈를 목록화합니다.
|
iids[]
| integer array | 아니오 | 주어진 iid 를 가진 이슈만 반환합니다
|
milestone
| string | 아니오 | 마일스톤 제목. None 은 마일스톤이없는 모든 이슈 목록입니다. Any 는 지정된 마일스톤이있는 모든 이슈를 목록화합니다.
|
scope
| string | 아니오 | 주어진 범위에 대한 이슈를 반환합니다. created_by_me , assigned_to_me 또는 all .
|
author_id
| integer | 아니오 | 주어진 사용자 id 가 만든 이슈를 반환합니다. author_username 과 상호 배타적입니다. scope=all 또는 scope=assigned_to_me 과 함께 사용합니다.
|
assignee_id
| integer | 아니오 | 주어진 사용자 id에 할당된 이슈를 반환합니다. assignee_username과 상호 배타적입니다. None은 할당되지 않은 이슈를 반환합니다. Any는 담당자가있는 이슈를 반환합니다. $
|
assignee_username
| string array | 아니오 | 주어진 username 에 할당된 이슈를 반환합니다. assignee_id 와 유사하며 상호 배타적입니다. GitLab CE에서 assignee_username 배열은 단일 값이거나 그렇지 않으면 잘못된 매개 변수 오류가 반환됩니다.
|
my_reaction_emoji
| string | 아니오 | 특정 이모지 로 인증된 사용자가 반응한 이슈를 반환합니다. None 은 반응이없는 이슈를 반환합니다. Any 는 적어도 하나의 반응이있는 이슈를 반환합니다.
|
search
| string | 아니오 | 그룹 이슈를 title 및 description 에 대해 검색합니다
|
created_after
| datetime | 아니오 | 주어진 시간 이후에 생성된 이슈를 반환합니다. ISO 8601 형식 예상 (2019-03-15T08:00:00Z )
|
created_before
| datetime | 아니오 | 주어진 시간 이전에 생성된 이슈를 반환합니다. ISO 8601 형식 예상 (2019-03-15T08:00:00Z )
|
updated_after
| datetime | 아니오 | 주어진 시간 이후에 업데이트된 이슈를 반환합니다. ISO 8601 형식 예상 (2019-03-15T08:00:00Z )
|
updated_before
| datetime | 아니오 | 주어진 시간 이전에 업데이트된 이슈를 반환합니다. ISO 8601 형식 예상 (2019-03-15T08:00:00Z )
|
confidential
| boolean | 아니오 | 기밀 또는 공개 이슈를 필터링합니다. |
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 /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
속성 | 타입 | 필수여부 | 설명 |
---|---|---|---|
id
| integer/string | yes | 프로젝트의 ID 또는 URL 인코딩된 경로 |
iids[]
| integer array | no | 주어진 iid 를 가진 마일스톤만 반환합니다.
|
labels
| string | no | 라벨 이름들의 쉼표로 구분된 목록으로, 이슈는 모든 라벨을 가지고 있어야 합니다. None 은 라벨이 없는 모든 이슈를 나열합니다. Any 는 최소한 하나의 라벨을 가진 모든 이슈를 나열합니다.
|
milestone
| string | no | 마일스톤 제목입니다. None 은 마일스톤이 지정되지 않은 모든 이슈를 나열합니다. Any 는 할당된 마일스톤을 가진 모든 이슈를 나열합니다.
|
scope
| string | no | 주어진 scope에 대한 이슈를 반환합니다: 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 와 유사하며, 상호 배타적입니다.
|
assignee_id
| integer | no | 주어진 사용자 id 에 할당된 이슈를 반환합니다. assignee_username 과 상호 배타적입니다. None 은 미할당된 이슈를 반환합니다. Any 는 담당자가 있는 이슈를 반환합니다.
|
assignee_username
| string array | no | 주어진 username 에 할당된 이슈를 반환합니다. assignee_id 와 유사하며, 상호 배타적입니다. GitLab CE에서 assignee_username 배열은 단일 값이거나 그렇지 않으면 잘못된 매개변수 오류가 반환됩니다.
|
my_reaction_emoji
| string | no | 사용자에 의해 주어진 emoji 로 반응된 이슈를 반환합니다. None 은 반응이 없는 이슈를 반환합니다. Any 는 최소한 하나의 반응이 있는 이슈를 반환합니다.
|
search
| string | no |
title 과 description 에 대해 프로젝트 이슈를 검색합니다.
|
created_after
| datetime | no | 주어진 시간 이후에 생성된 이슈를 반환합니다. ISO 8601 포맷(2019-03-15T08:00:00Z )을 기대합니다.
|
created_before
| datetime | no | 주어진 시간 이전에 생성된 이슈를 반환합니다. ISO 8601 포맷(2019-03-15T08:00:00Z )을 기대합니다.
|
updated_after
| datetime | no | 주어진 시간 이후에 업데이트된 이슈를 반환합니다. ISO 8601 포맷(2019-03-15T08:00:00Z )을 기대합니다.
|
updated_before
| datetime | no | 주어진 시간 이전에 업데이트된 이슈를 반환합니다. ISO 8601 포맷(2019-03-15T08:00:00Z )을 기대합니다.
|
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
}
}
}