문제 통계 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
}
}
}