이슈 통계 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
| 문자열 | 아니오 | 레이블 이름의 쉼표로 구분된 목록. 이슈는 모든 레이블을 갖고 있어야 합니다. None 은 레이블이 없는 모든 이슈를 나열합니다. Any 는 적어도 하나의 레이블을 갖고 있는 모든 이슈를 나열합니다.
|
milestone
| 문자열 | 아니오 | 마일스톤 제목. None 은 마일스톤이 지정되지 않은 모든 이슈를 나열합니다. Any 는 할당된 마일스톤이 있는 모든 이슈를 나열합니다.
|
scope
| 문자열 | 아니오 | 주어진 범위에 해당하는 이슈를 반환합니다: created_by_me , assigned_to_me , 또는 all . 기본값은 created_by_me
|
author_id
| 정수 | 아니오 | 주어진 사용자 id 가 생성한 이슈를 반환합니다. author_username 과 상호 배타적입니다. scope=all 또는 scope=assigned_to_me 과 조합하세요.
|
author_username
| 문자열 | 아니오 | 주어진 username 이 생성한 이슈를 반환합니다. author_id 와 유사하며 상호 배타적입니다.
|
assignee_id
| 정수 | 아니오 | 주어진 사용자 id 에 할당된 이슈를 반환합니다. assignee_username 과 상호 배타적입니다. None 은 미할당된 이슈를 반환합니다. Any 는 담당자가 있는 이슈를 반환합니다.
|
assignee_username
| 문자열 배열 | 아니오 | 주어진 username 에 할당된 이슈를 반환합니다. assignee_id 와 유사하며 상호 배타적입니다. GitLab CE에서는 assignee_username 배열에 하나의 값만 포함되어야 합니다. 그렇지 않으면 잘못된 매개변수 오류가 반환됩니다.
|
epic_id
| 정수 | 아니오 | 주어진 에픽 ID와 관련된 이슈를 반환합니다. None 은 주어진 에픽과 관련되지 않은 이슈를 반환합니다. Any 는 주어진 에픽과 관련된 이슈를 반환합니다. GitLab 13.6에서 도입되었습니다. 프리미엄 및 얼티메이트 전용.
|
my_reaction_emoji
| 문자열 | 아니오 | 해당 이모지 로 인증된 사용자가 반응한 이슈를 반환합니다. None 은 반응하지 않은 이슈를 반환합니다. Any 는 적어도 하나의 반응이 있는 이슈를 반환합니다.
|
iids[]
| 정수 배열 | 아니오 | 주어진 iid 를 갖는 이슈만 반환합니다
|
search
| 문자열 | 아니오 |
title 및 description 에 대해 이슈를 검색합니다
|
in
| 문자열 | 아니오 |
search 속성의 범위를 수정합니다. title , description , 또는 쉼표로 이어서 나열한 문자열. 기본값은 title,description
|
created_after
| 날짜 및 시간 | 아니오 | 주어진 시간 이후에 생성된 이슈를 반환합니다. ISO 8601 형식(2019-03-15T08:00:00Z )으로 입력하세요
|
created_before
| 날짜 및 시간 | 아니오 | 주어진 시간 이전에 생성된 이슈를 반환합니다. ISO 8601 형식(2019-03-15T08:00:00Z )으로 입력하세요
|
updated_after
| 날짜 및 시간 | 아니오 | 주어진 시간 이후에 업데이트된 이슈를 반환합니다. ISO 8601 형식(2019-03-15T08:00:00Z )으로 입력하세요
|
updated_before
| 날짜 및 시간 | 아니오 | 주어진 시간 이전에 업데이트된 이슈를 반환합니다. ISO 8601 형식(2019-03-15T08:00:00Z )으로 입력하세요
|
confidential
| 부울 | 아니오 | 비밀 또는 공개적인 이슈를 필터링합니다. |
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 과 함께 사용합니다.
|
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 배열에는 하나의 값만 포함되어야 합니다. 그렇지 않으면 잘못된 매개변수 오류가 반환됩니다.
|
my_reaction_emoji
| string | 아니요 | 인증된 사용자가 주어진 emoji 로 반응한 이슈를 반환합니다. 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 | 예 | 인증된 사용자가 소유한 프로젝트의 ID 또는 URL 인코딩된 경로 |
iids[]
| integer array | 아니요 | 주어진 iid 를 가진 마일스톤만 반환합니다.
|
labels
| string | 아니요 | 라벨 이름의 쉼표로 구분된 목록으로, 이슈는 모든 라벨을 가져와야 함. None 은 라벨이 없는 모든 이슈를 나열하고, Any 는 적어도 하나 이상의 라벨이 있는 모든 이슈를 나열합니다.
|
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 과 함께 사용합니다.
|
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 배열에는 하나의 값만 포함되어야 합니다. 그렇지 않으면 잘못된 매개변수 오류가 반환됩니다.
|
my_reaction_emoji
| string | 아니요 | 인증된 사용자가 주어진 emoji 로 반응한 이슈를 반환합니다. 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/projects/4/issues_statistics"
예시 응답:
{
"statistics": {
"counts": {
"all": 20,
"closed": 5,
"opened": 15
}
}
}