이모지 반응 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

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

이모지 반응은 수십 가지 단어를 설명합니다.

우리는 이모지로 반응할 수 있는 GitLab 객체를 “상장 가능한”이라고 부릅니다. 다음 항목에 대해 이모지로 반응할 수 있습니다:

이슈, 병합 요청, 및 스니펫

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

상장 가능한의 이모지 반응 목록

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

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 정수 예 상장 가능한의 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": "Issue"
  },
  {
    "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": "Issue"
  }
]

단일 이모지 반응 가져오기

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

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 정수 예 상장 가능한의 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": "Issue"
}

새로운 이모지 반응 추가

지정된 awardable에 이모지 반응을 추가합니다. 

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 integer/string 예 프로젝트의 ID 또는 URL-encoded 경로.
issue_iid/merge_request_iid/snippet_id integer 예 awardable의 ID (merge requests/issues의 경우 iid, snippets의 경우 id).
name string 예 콜론 없이 이모지의 이름. 
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 integer/string 예 프로젝트의 ID 또는 URL-encoded 경로.
issue_iid/merge_request_iid/snippet_id integer 예 awardable의 ID (merge requests/issues의 경우 iid, snippets의 경우 id).
award_id integer 예 이모지 반응의 ID. 
curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/award_emoji/344"

댓글에 반응 추가

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

참고: 아래 예제는 이슈 댓글에 대한 이모지 반응을 다룹니다만, MR 및 스니펫의 댓글로 적응시킬 수 있습니다. 따라서 issue_iid를 merge_request_iid 또는 snippet_id로 교체해야 합니다.

댓글의 이모지 반응 목록화

  • GitLab 15.1에서 변경되어 공개 코멘트에 대한 인증되지 않은 접근을 허용합니다.

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

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

매개변수:

속성 유형 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL-encoded 경로.
issue_iid integer 예 이슈의 내부 ID.
note_id integer 예 댓글(노트)의 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 예 프로젝트의 ID 또는 URL-encoded 경로.
issue_iid integer 예 이슈의 내부 ID.
note_id integer 예 댓글(노트)의 ID.
award_id integer 예 이모지 반응의 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"