이슈 통계 API
GitLab v19.5Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
요약
이 API를 사용해 이슈 관련 통계를 조회합니다. 사용자가 프로젝트의 멤버가 아니고 해당 프로젝트가 비공개이면, 그 프로젝트에 대한 GET 요청은 404 상태 코드를 반환합니다. 현재 사용자가 접근할 수 있는 이슈의 통계를 조회합니다.
이 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와 유사하며 author_id와 함께 사용할 수 없습니다. |
assignee_id |
integer | 아니요 | 지정한 사용자 id에게 할당된 이슈를 반환합니다. assignee_username과 함께 사용할 수 없습니다. None은 할당되지 않은 이슈를, Any는 담당자가 있는 이슈를 반환합니다. |
assignee_username |
string array | 아니요 | 지정한 username에게 할당된 이슈를 반환합니다. assignee_id와 유사하며 assignee_id와 함께 사용할 수 없습니다. GitLab CE에서는 assignee_username 배열에 값이 하나만 있어야 합니다. 그렇지 않으면 잘못된 파라미터 오류가 반환됩니다. |
epic_id |
integer | 아니요 | 지정한 에픽 ID에 연결된 이슈를 반환합니다. None은 에픽에 연결되지 않은 이슈를, Any는 에픽에 연결된 이슈를 반환합니다. Premium 및 Ultimate 전용입니다. |
my_reaction_emoji |
string | 아니요 | 인증된 사용자가 지정한 emoji로 반응한 이슈를 반환합니다. 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 --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "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 or 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와 유사하며 author_id와 함께 사용할 수 없습니다. |
assignee_id |
integer | 아니요 | 지정한 사용자 id에게 할당된 이슈를 반환합니다. assignee_username과 함께 사용할 수 없습니다. None은 할당되지 않은 이슈를, Any는 담당자가 있는 이슈를 반환합니다. |
assignee_username |
string array | 아니요 | 지정한 username에게 할당된 이슈를 반환합니다. assignee_id와 유사하며 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 --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "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 or 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와 유사하며 author_id와 함께 사용할 수 없습니다. |
assignee_id |
integer | 아니요 | 지정한 사용자 id에게 할당된 이슈를 반환합니다. assignee_username과 함께 사용할 수 없습니다. None은 할당되지 않은 이슈를, Any는 담당자가 있는 이슈를 반환합니다. |
assignee_username |
string array | 아니요 | 지정한 username에게 할당된 이슈를 반환합니다. assignee_id와 유사하며 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 --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/projects/4/issues_statistics"
응답 예시:
{
"statistics": {
"counts": {
"all": 20,
"closed": 5,
"opened": 15
}
}
}