Skip to content

Latest commit

 

History

History
79 lines (72 loc) · 3.07 KB

README.md

File metadata and controls

79 lines (72 loc) · 3.07 KB

VimeWorld SkinService

Высокопроизводительный сервис для аватарок из скинов проекта VimeWorld.ru. Его также можно подключить к любой другой системе скинов, как к локальной (файлы на том же хосте), так и к удалённой (через http запросы).

Для полноценной работы рекомендуется использовать CloudFlare поверх сервиса. Он позволяет кешировать все сгенерированные аватарки, тем самым значительно снижая нагрузку на сам сервис. При изменении скина или плаща можно удалить весь кеш с помощью приватных методов очистки.

Рабочая версия запущена здесь: http://skin.vimeworld.ru

Публичное API

Скин

Вид скина спереди со вторым слоем на голове:

GET /body/{username}.png
GET /body/{username}/{size}.png

Вид скина сзади со вторым слоем на голове:

GET /back/{username}.png
GET /back/{username}/{size}.png

Голова без второго слоя:

GET /head/{username}.png
GET /head/{username}/{size}.png

Голова со вторым слоем (со шлемом):

GET /helm/{username}.png
GET /helm/{username}/{size}.png

Изометрическая голова:

GET /head/3d/{username}.png
GET /head/3d/{username}/{size}.png

Изометрическая голова со шлемом:

GET /helm/3d/{username}.png
GET /helm/3d/{username}/{size}.png

Оригинальный скин:

GET /raw/skin/{username}.png

Плащ

Задняя сторона плаща (которая чаще всего видна игрокам):

GET /cape/{username}.png

Оригинальный плащ:

GET /raw/cape/{username}.png

Скины и плащи для игры

Скины:

GET /game/v1/skin/{username}.png - Для версий 1.0 - 1.7.10
GET /game/v2/skin/{username}.png - Для версий 1.8 и выше

Плащи:

GET /game/v1/cape/{username}.png - Для версий 1.0 - 1.5.2
GET /game/v2/cape/{username}.png - Для версий 1.6 и выше

Приватное API

Для доступа к приватному API необходимо иметь токен авторизации, который указывается в конфиге. Все приватные методы начинаются с /private/{token}/.

Очистка кеша

Удаление плаща из кеша сервиса и CloudFlare:

DELETE /private/{token}/cache/cape/{username}

Удаление скина и всех вытекающих из кеша сервиса и CloudFlare:

DELETE /private/{token}/cache/skin/{username}