이슈 통계 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
| 정수 | 아니오 | 주어진 epic ID와 연관된 이슈를 반환합니다. None 은 epic과 연관되지 않은 이슈를 반환하며, Any 는 epic과 연관된 이슈를 반환합니다. GitLab 13.6에서 도입. Premium 및 Ultimate 전용
|
my_reaction_emoji
| 문자열 | 아니오 | 특정 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
| 정수/문자열 | 예 | 인증된 사용자가 소유한 그룹의 ID 또는 URL 인코딩된 경로 |
labels
| 문자열 | 아니오 | 라벨 이름의 쉼표로 구분된 디렉터리으로, 이슈는 모든 라벨을 갖고 있어야 합니다. None 은 라벨이 없는 모든 이슈를 나열합니다. Any 는 최소한 하나의 라벨을 갖고 있는 모든 이슈를 나열합니다.
|
iids[]
| 정수 배열 | 아니오 | 주어진 iid 를 가진 이슈만 반환합니다.
|
milestone
| 문자열 | 아니오 | 마일스톤 제목. None 은 마일스톤이 지정되지 않은 모든 이슈를 나열합니다. Any 는 할당된 마일스톤이 있는 모든 이슈를 나열합니다.
|
scope
| 문자열 | 아니오 | 주어진 범위의 이슈를 반환합니다: created_by_me , assigned_to_me 또는 all .
|
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 배열은 하나의 값만 포함하거나 그렇지 않으면 잘못된 매개변수 오류가 반환됩니다.
|
my_reaction_emoji
| 문자열 | 아니오 | 특정 emoji 로 인증된 사용자가 반응한 이슈를 반환합니다. None 은 반응하지 않은 이슈를 반환하며, Any 는 적어도 하나의 반응을 받은 이슈를 반환합니다.
|
search
| 문자열 | 아니오 | 그룹 이슈를 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/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 | 주어진 범위의 이슈 반환: 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
}
}
}