Перейти к содержимому

Свой набор через API

Набор создаётся четырьмя запросами: получить токен, создать набор, загрузить эмодзи, при желании поменять порядок. Во всех примерах $TOKEN - access-токен из раздела вход и токены.

Окно терминала
curl -X POST https://api.vpulse.fun/emoji/packs \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"slug": "MyStickers", "title": "Мои эмодзи"}'

slug - короткое имя набора: латиница, цифры и _, от 4 до 32 символов, начинается с буквы. Оно уникально для всего Pulse. title - название, которое видят пользователи, до 64 символов.

У одного автора может быть до 20 наборов.

Каждый эмодзи загружается отдельным запросом multipart/form-data с полями file и fallback:

Окно терминала
curl -X POST https://api.vpulse.fun/emoji/packs/MyStickers/emoji \
-H "Authorization: Bearer $TOKEN" \
-F "file=@fire.tgs" \
-F "fallback=🔥"

В ответе придёт эмодзи с его id. Если файл не подходит по требованиям, сервер вернёт ошибку с понятным текстом, например «Анимация длиннее 3 секунд». В наборе может быть до 200 эмодзи.

Порядок в наборе совпадает с порядком загрузки. Чтобы поменять его, передайте все id в нужном порядке:

Окно терминала
curl -X PUT https://api.vpulse.fun/emoji/packs/MyStickers/order \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"ids": ["id-первого", "id-второго"]}'

Набор появляется в панели у тех, кто его добавил. Добавить может подписчик Premium:

Окно терминала
curl -X POST https://api.vpulse.fun/emoji/packs/MyStickers/install \
-H "Authorization: Bearer $TOKEN"
  • PATCH /emoji/packs/{slug} с {"title": "..."} меняет название.
  • DELETE /emoji/packs/{slug}/emoji/{id} удаляет один эмодзи.
  • DELETE /emoji/packs/{slug} удаляет весь набор вместе с файлами.

Менять набор может только его автор. Удалённые эмодзи в уже отправленных сообщениях превращаются в свой запасной обычный эмодзи.

Полный список методов: методы премиум-эмодзи.