이슈 통계 API
Offering: 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 |
문자열 | 아니요 | 쉼표로 구분된 레이블 이름 목록, 이슈는 반환되려면 모든 레이블을 가지고 있어야 합니다. 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와 유사하며 author_id와 상호 배타적입니다. |
assignee_id |
정수 | 아니요 | 주어진 사용자 id에게 할당된 이슈를 반환합니다. assignee_username과 상호 배타적입니다. None은 할당되지 않은 이슈를 반환합니다. Any는 담당자가 있는 이슈를 반환합니다. |
assignee_username |
문자열 배열 | 아니요 | 주어진 username에게 할당된 이슈를 반환합니다. assignee_id와 유사하며 assignee_id와 상호 배타적입니다. GitLab CE에서 assignee_username 배열은 단일 값만 포함해야 하며, 그렇지 않으면 잘못된 파라미터 오류가 반환됩니다. |
epic_id |
정수 | 아니요 | 주어진 에픽 ID와 연관된 이슈를 반환합니다. None은 에픽과 연관되지 않은 이슈를 반환합니다. Any는 에픽과 연관된 이슈를 반환합니다. Premium 및 Ultimate 전용. |
my_reaction_emoji |
문자열 | 아니요 | 인증된 사용자가 주어진 emoji로 반응한 이슈를 반환합니다. None은 반응이 없는 이슈를 반환합니다. Any는 하나 이상의 반응이 있는 이슈를 반환합니다. |
iids[] |
정수 배열 | 아니요 | 주어진 iid를 가진 이슈만 반환합니다 |
search |
문자열 | 아니요 | title 및 description을 기반으로 이슈를 검색합니다 |
in |
문자열 | 아니요 | 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 |
불리언 | 아니요 | 기밀 또는 공개 이슈를 필터링합니다. |
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 |
정수 또는 문자열 | 예 | 그룹의 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와 유사하며 author_id와 상호 배타적입니다. |
assignee_id |
정수 | 아니요 | 주어진 사용자 id에게 할당된 이슈를 반환합니다. assignee_username과 상호 배타적입니다. None은 할당되지 않은 이슈를 반환합니다. Any는 담당자가 있는 이슈를 반환합니다. |
assignee_username |
문자열 배열 | 아니요 | 주어진 username에게 할당된 이슈를 반환합니다. assignee_id와 유사하며 assignee_id와 상호 배타적입니다. GitLab CE에서 assignee_username 배열은 단일 값만 포함해야 하며, 그렇지 않으면 잘못된 파라미터 오류가 반환됩니다. |
my_reaction_emoji |
문자열 | 아니요 | 인증된 사용자가 주어진 emoji로 반응한 이슈를 반환합니다. None은 반응이 없는 이슈를 반환합니다. Any는 하나 이상의 반응이 있는 이슈를 반환합니다. |
search |
문자열 | 아니요 | 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 |
불리언 | 아니요 | 기밀 또는 공개 이슈를 필터링합니다. |
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 |
정수 또는 문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
iids[] |
정수 배열 | 아니요 | 주어진 iid를 가진 이슈만 반환합니다 |
labels |
문자열 | 아니요 | 쉼표로 구분된 레이블 이름 목록, 이슈는 반환되려면 모든 레이블을 가지고 있어야 합니다. None은 레이블이 없는 모든 이슈를 나열합니다. Any는 하나 이상의 레이블이 있는 모든 이슈를 나열합니다. |
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와 유사하며 author_id와 상호 배타적입니다. |
assignee_id |
정수 | 아니요 | 주어진 사용자 id에게 할당된 이슈를 반환합니다. assignee_username과 상호 배타적입니다. None은 할당되지 않은 이슈를 반환합니다. Any는 담당자가 있는 이슈를 반환합니다. |
assignee_username |
문자열 배열 | 아니요 | 주어진 username에게 할당된 이슈를 반환합니다. assignee_id와 유사하며 assignee_id와 상호 배타적입니다. GitLab CE에서 assignee_username 배열은 단일 값만 포함해야 하며, 그렇지 않으면 잘못된 파라미터 오류가 반환됩니다. |
my_reaction_emoji |
문자열 | 아니요 | 인증된 사용자가 주어진 emoji로 반응한 이슈를 반환합니다. None은 반응이 없는 이슈를 반환합니다. Any는 하나 이상의 반응이 있는 이슈를 반환합니다. |
search |
문자열 | 아니요 | 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 |
불리언 | 아니요 | 기밀 또는 공개 이슈를 필터링합니다. |
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
}
}
}
