https://github.com/vimeworld/skinservice
VimeWorld.com Minecraft Skin Service
https://github.com/vimeworld/skinservice
cloudflare image-api java minecraft minecraft-avatar vimeworld
Last synced: 4 days ago
JSON representation
VimeWorld.com Minecraft Skin Service
- Host: GitHub
- URL: https://github.com/vimeworld/skinservice
- Owner: VimeWorld
- Created: 2016-06-17T00:23:36.000Z (over 9 years ago)
- Default Branch: master
- Last Pushed: 2025-01-11T10:12:44.000Z (about 1 year ago)
- Last Synced: 2025-01-11T11:26:43.967Z (about 1 year ago)
- Topics: cloudflare, image-api, java, minecraft, minecraft-avatar, vimeworld
- Language: Java
- Homepage: https://vimeworld.com
- Size: 8.89 MB
- Stars: 12
- Watchers: 2
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
VimeWorld SkinService
====================
Высокопроизводительный сервис для аватарок из скинов проекта [VimeWorld.com](https://vimeworld.com). Его также можно подключить к любой другой системе скинов, как к локальной (файлы на том же хосте), так и к удалённой (через http запросы).
Для полноценной работы рекомендуется использовать CloudFlare поверх сервиса. Он позволяет кешировать все сгенерированные аватарки, тем самым значительно снижая нагрузку на сам сервис. При изменении скина или плаща можно удалить весь кеш с помощью приватных методов очистки.
Рабочая версия запущена здесь: [https://skin.vimeworld.com](https://skin.vimeworld.com)
## Публичное 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}
```