문제 통계 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는 에픽과 관련된 문제를 반환합니다. 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 |
정수/문자열 | 예 | 프로젝트의 ID 또는 URL 인코딩된 경로 |
iids[] |
정수 배열 | 아니오 | 주어진 iid가 있는 마일스톤만 반환합니다. |
labels |
문자열 | 아니오 | 이슈에 모두 포함되어야 하는 레이블 이름의 쉼표로 구분된 목록. 없음은 레이블이 없는 모든 이슈를 나열합니다. 임의는 적어도 하나의 레이블이 있는 모든 이슈를 나열합니다. |
milestone |
문자열 | 아니오 | 마일스톤 제목. 없음은 마일스톤이 없는 모든 이슈를 나열합니다. 임의는 할당된 마일스톤이 있는 모든 이슈를 나열합니다. |
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과 상호 배타적입니다. 없음은 할당되지 않은 이슈를 반환합니다. 임의는 할당된 이슈를 반환합니다. |
assignee_username |
문자열 배열 | 아니오 | 주어진 username에 할당된 이슈를 반환합니다. assignee_id와 유사하며 상호 배타적입니다. GitLab CE에서 assignee_username 배열은 단일 값만 포함해야 하며, 그렇지 않으면 잘못된 매개변수 오류가 반환됩니다. |
my_reaction_emoji |
문자열 | 아니오 | 인증된 사용자가 주어진 emoji로 반응한 이슈를 반환합니다. 없음은 반응이 없는 이슈를 반환합니다. 임의는 최소한 하나의 반응이 있는 이슈를 반환합니다. |
search |
문자열 | 아니오 | 이슈의 제목 및 설명에 대해 프로젝트 이슈를 검색합니다. |
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/projects/4/issues_statistics"
예제 응답:
{
"statistics": {
"counts": {
"all": 20,
"closed": 5,
"opened": 15
}
}
}
도움말