Методы премиум-эмодзи
Все методы требуют заголовок Authorization: Bearer <accessToken>. {slug} - короткое имя набора.
| Метод | Что возвращает |
|---|---|
GET /emoji/packs |
наборы, которые пользователь добавил или создал |
GET /emoji/featured |
официальные наборы Pulse |
GET /emoji/packs/{slug} |
один набор со всеми эмодзи |
GET /emoji/custom?ids=id1,id2 |
эмодзи по идентификаторам, например чтобы нарисовать полученное сообщение |
Набор в ответе выглядит так:
{ "id": "cmwi...", "slug": "StackWorks", "title": "StackWorks", "author": { "id": "...", "pulseId": "pulse", "displayName": "Pulse" }, "mine": false, "installed": true, "emoji": [ { "id": "cmwijd9z4000201pg76brkwuz", "url": "/uploads/emoji-packs/cmwijd9z4000201pg76brkwuz.tgs", "format": "tgs", "fallback": "🔥" } ]}url относительный, файл скачивается с https://api.vpulse.fun плюс этот путь. Сервер может ответить перенаправлением на хранилище, клиенту нужно следовать за ним.
Подписка на набор
Заголовок раздела «Подписка на набор»| Метод | Действие |
|---|---|
POST /emoji/packs/{slug}/install |
добавить набор себе, нужен Premium |
DELETE /emoji/packs/{slug}/install |
убрать набор из своей панели |
Свои наборы
Заголовок раздела «Свои наборы»| Метод | Тело | Действие |
|---|---|---|
POST /emoji/packs |
{"slug", "title"} |
создать набор |
PATCH /emoji/packs/{slug} |
{"title"} |
переименовать |
DELETE /emoji/packs/{slug} |
- | удалить вместе с файлами |
POST /emoji/packs/{slug}/emoji |
multipart: file, fallback |
добавить эмодзи |
DELETE /emoji/packs/{slug}/emoji/{id} |
- | удалить эмодзи |
PUT /emoji/packs/{slug}/order |
{"ids": [...]} |
задать порядок |
PATCH /me/emoji-status с {"emojiId": "..."} ставит премиум-эмодзи статусом рядом с именем, {"emojiId": null} убирает. Ставить статус можно только с Premium.
Коды ошибок описаны в разделе ошибки.