Award Emoji API · Gitlab 中文文檔

# Award Emoji API > 原文：[https://docs.gitlab.com/ee/api/award_emoji.html](https://docs.gitlab.com/ee/api/award_emoji.html) * [Issues, merge requests, and snippets](#issues-merge-requests-and-snippets) * [List an awardable’s award emoji](#list-an-awardables-award-emoji) * [Get single award emoji](#get-single-award-emoji) * [Award a new emoji](#award-a-new-emoji) * [Delete an award emoji](#delete-an-award-emoji) * [Award Emoji on Comments](#award-emoji-on-comments) * [List a comment’s award emoji](#list-a-comments-award-emoji) * [Get an award emoji for a comment](#get-an-award-emoji-for-a-comment) * [Award a new emoji on a comment](#award-a-new-emoji-on-a-comment) * [Delete an award emoji from a comment](#delete-an-award-emoji-from-a-comment) # Award Emoji API[](#award-emoji-api "Permalink") 在 GitLab 8.9 中[引入](https://gitlab.com/gitlab-org/gitlab-foss/-/merge_requests/4575) . 在 8.12 中添加了代碼段支持. [獲獎的表情符號](../user/award_emojis.html)講出一千個單詞. 可以通過以下方式授予表情符號（稱為"獎項"）： * [Issues](../user/project/issues/index.html) ([API](issues.html)). * [Merge requests](../user/project/merge_requests/index.html) ([API](merge_requests.html)). * [Snippets](../user/snippets.html) ([API](snippets.html)). Emoji can also [be awarded](../user/award_emojis.html#award-emoji-for-comments) on comments (also known as notes). See also [Notes API](notes.html). ## Issues, merge requests, and snippets[](#issues-merge-requests-and-snippets "Permalink") 有關將這些端點與注釋一起使用的信息，請參見[在注釋](#award-emoji-on-comments)上[授予 Emoji 表情](#award-emoji-on-comments) . ### List an awardable’s award emoji[](#list-an-awardables-award-emoji "Permalink") 獲取指定獎勵的所有獎勵表情符號的列表. ``` 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 ``` Parameters: | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) . | | `issue_iid`/`merge_request_iid`/`snippet_id` | integer | yes | `iid` ID（合并請求/問題的`id` ，摘要的`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 single award emoji[](#get-single-award-emoji "Permalink") 從問題，摘要或合并請求中獲取單個獎勵表情符號. ``` 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 ``` Parameters: | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) . | | `issue_iid`/`merge_request_iid`/`snippet_id` | integer | yes | `iid` ID（合并請求/問題的`id` ，摘要的`id` ）. | | `award_id` | integer | yes | 獎勵表情符號的 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" } ``` ### Award a new emoji[](#award-a-new-emoji "Permalink") 在指定的獎勵對象上創建獎勵表情符號. ``` 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 ``` Parameters: | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) . | | `issue_iid`/`merge_request_iid`/`snippet_id` | integer | yes | `iid` ID（合并請求/問題的`id` ，摘要的`id` ）. | | `name` | string | yes | 不含冒號的表情符號名稱. | ``` 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 an award emoji[](#delete-an-award-emoji "Permalink") 有時候，這并不是必須的，您必須取消該獎項. **注意：**僅適用于管理員或獎項的作者. ``` 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 ``` Parameters: | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) . | | `issue_iid`/`merge_request_iid`/`snippet_id` | integer | yes | `iid` ID（合并請求/問題的`id` ，摘要的`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/344" ``` ## Award Emoji on Comments[](#award-emoji-on-comments "Permalink") 注釋（也稱為注釋）是問題，合并請求和摘要的子資源. **注意：**以下示例描述了如何使用獎勵表情符號處理問題的注釋，但可以輕松地將其用于合并請求或摘要中的注釋. 因此，您必須用`merge_request_iid`或`snippet_id`替換`issue_iid` . ### List a comment’s award emoji[](#list-a-comments-award-emoji "Permalink") 獲取所有獎勵表情符號的評論（注釋）. ``` GET /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji ``` Parameters: | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) . | | `issue_iid` | integer | yes | 問題的內部 ID. | | `note_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" ``` 響應示例： ``` [ { "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" } ] ``` ### Get an award emoji for a comment[](#get-an-award-emoji-for-a-comment "Permalink") 獲得單個獎勵表情符號作為注釋（注釋）. ``` GET /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji/:award_id ``` Parameters: | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) . | | `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" } ``` ### Award a new emoji on a comment[](#award-a-new-emoji-on-a-comment "Permalink") 在指定的注釋（注釋）上創建一個獎勵表情符號. ``` POST /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji ``` Parameters: | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) . | | `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 an award emoji from a comment[](#delete-an-award-emoji-from-a-comment "Permalink") 有時候，這并不是必須的，您必須取消該獎項. **注意：**僅適用于管理員或獎項的作者. ``` DELETE /projects/:id/issues/:issue_iid/notes/:note_id/award_emoji/:award_id ``` Parameters: | Attribute | Type | Required | Description | | --- | --- | --- | --- | | `id` | integer/string | yes | 項目的 ID 或[URL 編碼路徑](README.html#namespaced-path-encoding) . | | `issue_iid` | integer | yes | 問題的內部 ID. | | `note_id` | integer | yes | 注釋（注釋）的 ID. | | `award_id` | integer | yes | award_emoji 的 ID. | 請求示例： ``` curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/1/issues/80/award_emoji/345" ```