이모지 반응 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, 자체 관리, GitLab Dedicated

GitLab 16.0에서 “award emoji”가 “이모지 반응”으로 이름이 변경되었습니다.

이모지 반응은 수천 개의 단어로 표현됩니다.

우리는 이모지로 반응할 수 있는 GitLab 객체를 “awardables”라고 부릅니다. 다음에 이모지로 반응할 수 있습니다:

이슈, 병합 요청, 그리고 스니펫

이 엔드포인트를 코멘트와 함께 사용하는 정보는 코멘트에 반응 추가를 참조하세요.

awardable의 이모지 반응 목록

  • GitLab 15.1에서 공개 awardable에 대한 인증되지 않은 액세스를 허용하도록 변경되었습니다.

지정된 awardable의 모든 이모지 반응 목록을 가져옵니다. 이 엔드포인트는 awardable이 공개적으로 접근 가능한 경우 인증 없이 액세스할 수 있습니다. 

GET /projects/:id/issues/:issue_iid/award_emoji
GET /projects/:id/merge_requests/:merge_request_iid/award_emoji
GET /projects/:id/snippets/:snippet_id/award_emoji

파라미터:

속성 타입 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL-encoded 경로.
issue_iid/merge_request_iid/snippet_id 정수 예 awardable의 ID (이슈/병합 요청 에 대한 iid, 스니펫에 대한 id)

예시 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/award_emoji"

예시 응답: 

[
  {
    "id": 4,
    "name": "1234",
    "user": {
      "name": "Administrator",
      "username": "root",
      "id": 1,
      "state": "active",
      "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
      "web_url": "http://gitlab.example.com/root"
    },
    "created_at": "2016-06-15T10:09:34.206Z",
    "updated_at": "2016-06-15T10:09:34.206Z",
    "awardable_id": 80,
    "awardable_type": "이슈"
  },
  {
    "id": 1,
    "name": "microphone",
    "user": {
      "name": "User 4",
      "username": "user4",
      "id": 26,
      "state": "active",
      "avatar_url": "http://www.gravatar.com/avatar/7e65550957227bd38fe2d7fbc6fd2f7b?s=80&d=identicon",
      "web_url": "http://gitlab.example.com/user4"
    },
    "created_at": "2016-06-15T10:09:34.177Z",
    "updated_at": "2016-06-15T10:09:34.177Z",
    "awardable_id": 80,
    "awardable_type": "이슈"
  }
]

단일 이모지 반응 가져오기

  • GitLab 15.1에서 공개 awardable에 대한 인증되지 않은 액세스를 허용하도록 변경되었습니다.

이슈, 스니펫 또는 병합 요청로부터 단일 이모지 반응을 가져옵니다. 이 엔드포인트는 awardable이 공개적으로 접근 가능한 경우 인증 없이 액세스할 수 있습니다. 

GET /projects/:id/issues/:issue_iid/award_emoji/:award_id
GET /projects/:id/merge_requests/:merge_request_iid/award_emoji/:award_id
GET /projects/:id/snippets/:snippet_id/award_emoji/:award_id

파라미터:

속성 타입 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL-encoded 경로.
issue_iid/merge_request_iid/snippet_id 정수 예 awardable의 ID (이슈/병합 요청에 대한 iid, 스니펫에 대한 id)
award_id 정수 예 이모지 반응의 ID

예시 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/award_emoji/1"

예시 응답: 

{
  "id": 1,
  "name": "microphone",
  "user": {
    "name": "User 4",
    "username": "user4",
    "id": 26,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/7e65550957227bd38fe2d7fbc6fd2f7b?s=80&d=identicon",
    "web_url": "http://gitlab.example.com/user4"
  },
  "created_at": "2016-06-15T10:09:34.177Z",
  "updated_at": "2016-06-15T10:09:34.177Z",
  "awardable_id": 80,
  "awardable_type": "이슈"
}

새로운 이모지 반응 추가하기

지정된 수상 대상에 이모지 반응을 추가합니다. 

POST /projects/:id/issues/:issue_iid/award_emoji
POST /projects/:id/merge_requests/:merge_request_iid/award_emoji
POST /projects/:id/snippets/:snippet_id/award_emoji

매개변수:

속성 유형 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
issue_iid/merge_request_iid/snippet_id 정수 예 상 받을 수 있는 대상의 ID (병합 요청/이슈에 대한 iid, 스니펫의 경우 id).
name 문자열 예 콜론 없이 이모지의 이름. 
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/award_emoji?name=blowfish"

예시 응답: 

{
  "id": 344,
  "name": "blowfish",
  "user": {
    "name": "Administrator",
    "username": "root",
    "id": 1,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
    "web_url": "http://gitlab.example.com/root"
  },
  "created_at": "2016-06-17T17:47:29.266Z",
  "updated_at": "2016-06-17T17:47:29.266Z",
  "awardable_id": 80,
  "awardable_type": "Issue"
}

이모지 반응 삭제

가끔은 시기가 아니거나 반응을 제거해야 할 때가 있습니다.

관리자 또는 반응의 작성자만 이모지 반응을 삭제할 수 있습니다. 

DELETE /projects/:id/issues/:issue_iid/award_emoji/:award_id
DELETE /projects/:id/merge_requests/:merge_request_iid/award_emoji/:award_id
DELETE /projects/:id/snippets/:snippet_id/award_emoji/:award_id

매개변수:

속성 유형 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
issue_iid/merge_request_iid/snippet_id 정수 예 상 받을 수 있는 대상의 ID (병합 요청/이슈에 대한 iid, 스니펫의 경우 id).
award_id 정수 예 이모지 반응의 ID. 
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/award_emoji/344"

댓글에 반응 추가하기

댓글(노트로도 알려짐)은 이슈, 병합 요청 및 스니펫의 하위 리소스입니다.

참고: 아래 예시는 이슈의 댓글에 이모지 반응을 처리하는 방법을 설명하지만, 병합 요청 및 스니펫에 적용할 수 있습니다. 따라서 issue_iid를 merge_request_iid 또는 snippet_id로 교체해야 합니다.

댓글의 이모지 반응 목록

  • GitLab 15.1에서 변경되었습니다 : 공개 댓글에 대한 인증되지 않은 액세스 허용.

댓글에 대한 모든 이모지 반응을 가져옵니다. 이 엔드포인트는 댓글이 공개적으로 접근 가능한 경우 인증없이 액세스할 수 있습니다. 

GET /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji

매개변수:

속성 유형 필수 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL 인코딩된 경로.
issue_iid 정수 예 이슈의 내부 ID.
note_id 정수 예 댓글(노트)의 ID.

예시 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/notes/1/award_emoji"

예시 응답: 

[
  {
    "id": 2,
    "name": "mood_bubble_lightning",
    "user": {
      "name": "User 4",
      "username": "user4",
      "id": 26,
      "state": "active",
      "avatar_url": "http://www.gravatar.com/avatar/7e65550957227bd38fe2d7fbc6fd2f7b?s=80&d=identicon",
      "web_url": "http://gitlab.example.com/user4"
    },
    "created_at": "2016-06-15T10:09:34.197Z",
    "updated_at": "2016-06-15T10:09:34.197Z",
    "awardable_id": 1,
    "awardable_type": "Note"
  }
]

댓글에 대한 이모지 반응 가져오기

  • 변경 사항인 GitLab 15.1에서 공개 댓글에 대한 인증되지 않은 액세스를 허용하도록 변경되었습니다.

주석(노트)에 대한 단일 이모지 반응을 가져옵니다. 댓글이 공개적으로 접근 가능한 경우 인증 없이 이 엔드포인트에 액세스할 수 있습니다. 

GET /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji/:award_id

매개변수:

속성 타입 필수 설명
id integer/string yes 프로젝트의 ID 또는 URL 인코딩된 경로.
issue_iid integer yes 이슈의 내부 ID.
note_id integer yes 댓글(주석)의 ID.
award_id integer yes 이모지 반응의 ID.

예시 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/notes/1/award_emoji/2"

예시 응답: 

{
  "id": 2,
  "name": "mood_bubble_lightning",
  "user": {
    "name": "User 4",
    "username": "user4",
    "id": 26,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/7e65550957227bd38fe2d7fbc6fd2f7b?s=80&d=identicon",
    "web_url": "http://gitlab.example.com/user4"
  },
  "created_at": "2016-06-15T10:09:34.197Z",
  "updated_at": "2016-06-15T10:09:34.197Z",
  "awardable_id": 1,
  "awardable_type": "Note"
}

댓글에 새 이모지 반응 추가하기

지정된 댓글(주석)에 이모지 반응을 만듭니다. 

POST /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji

매개변수:

속성 타입 필수 설명
id integer/string yes 프로젝트의 ID 또는 URL 인코딩된 경로.
issue_iid integer yes 이슈의 내부 ID.
note_id integer yes 댓글(주석)의 ID.
name string yes 콜론 없는 이모지의 이름.

예시 요청: 

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/notes/1/award_emoji?name=rocket"

예시 응답: 

{
  "id": 345,
  "name": "rocket",
  "user": {
    "name": "Administrator",
    "username": "root",
    "id": 1,
    "state": "active",
    "avatar_url": "http://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
    "web_url": "http://gitlab.example.com/root"
  },
  "created_at": "2016-06-17T19:59:55.888Z",
  "updated_at": "2016-06-17T19:59:55.888Z",
  "awardable_id": 1,
  "awardable_type": "Note"
}

댓글에서 이모지 반응 삭제하기

가끔은 운명이 아니다보니 반응을 제거해야 할 때가 있습니다.

이모지 반응은 관리자 또는 반응의 작성자만 삭제할 수 있습니다. 

DELETE /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji/:award_id

매개변수:

속성 타입 필수 설명
id integer/string yes 프로젝트의 ID 또는 URL 인코딩된 경로.
issue_iid integer yes 이슈의 내부 ID.
note_id integer yes 댓글(주석)의 ID.
award_id integer yes 이모지 반응의 ID.

예시 요청: 

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/award_emoji/345"