Установить скин

POST

https://api.easyx.ru/v2/user/minecraft/skins

Описание

Запрос служит для установки Minecraft скина пользователя.

Запрос требует право minecraft.textures:write.

---

Заголовки

Required

Authorization

Header

Bearer: token

Запрос

Request body schema form-data

file

File

Файл скина.
Максимальный размер: 1 МБ.
Допустимые разрешения: 64x64, 64x32, 128x128, 128x64, 256x256, 256x128, 512x512, 512x256, 1024x1024, 1024x512.
Параметр обязателен, если не передан id.

id

UInt

Идентификатор ранее установленного скина.
Возвращается в запросе на получение всех скинов.
Параметр обязателен, если не передан file.

name

String[5..60]

Название файла.
Будет установлен в заголовке Content-Disposition, если файл ранее загружен не был.
Если не передан, используется оригинальное название файла.

is_current

Boolean

Скин по умолчанию.
Если передано 1, скин закрепится за пользователем как текущий.
Если передано 0, скин добавится в коллекцию пользователя и будет участвовать в ответе на запрос Получить все скины.
По умолчанию 1.

Ответ

200

Успешный запрос

Required

id

Char[40]

Идентификатор скина. Представляет из себя хеш-сумму файла (SHA1).

Required

width

UInt

Ширина скина.

Required

height

UInt

Высота скина.

Required

size

UInt

Размер скина в байтах.

Required

url

String

Ссылка на скачивание скина.

Required

is_current

Boolean

Скин по умолчанию.

401

Требуется авторизация

Required

error

Required

code

String

Код ошибки

Required

message

String

Текстовое описание ошибки

403

Недостаточно прав

Required

error

Required

code

String

Код ошибки

Required

message

String

Текстовое описание ошибки

422

Ошибка в параметрах

Required

error

Required

code

String

Код ошибки

Required

message

String

Текстовое описание ошибки

Required

field

String

Имя некорректного параметра

500

Сервис временно недоступен

Required

error

Required

code

String

Код ошибки

Required

message

String

Текстовое описание ошибки

Пример запроса

Payload

cURL

PHP

Content Type

application/json

{}

curl --location 'https://api.easyx.ru/v2/user/skins' \
--header 'Authorization: Bearer <TOKEN>'

curl

GuzzleHttp

<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => 'https://api.easyx.ru/v2/user/skins',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_FOLLOWLOCATION => true,
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer $token"
    ]
]);

$response = curl_exec($curl);

curl_close($curl);

<?php

use GuzzleHttp\Client;

$client = new Client;

$request = $client->get('https://api.easyx.ru/v2/user/skins', [
    'headers' => [
        'Authorization' => "Bearer $token"
    ]
]);

$response = $request->getBody()->getContents();

Пример ответа

200

401

403

422

422

500

Content Type

application/json

[
    {
        "id": "918ef4723259eec6aeeef67e9c5b0879ab39fee8",
        "width": 64,
        "height": 64,
        "size": 3286,
        "url": "https://skins.easyxcdn.net/91/8e/918ef4723259eec6aeeef67e9c5b0879ab39fee8",
        "is_current": false
    },
    {
        "id": "abb10e8dc11cba1f6db6c02765fbcb32aeff319b",
        "width": 64,
        "height": 64,
        "size": 2091,
        "url": "https://skins.easyxcdn.net/ab/b1/abb10e8dc11cba1f6db6c02765fbcb32aeff319b",
        "is_current": true
    }
]

{
    "error": {
        "code": "UNAUTHORIZED",
        "message": "Authorization required"
    }
}

{
    "error": {
        "code": "INSUFFICIENT_SCOPE",
        "message": "The access token has insufficient scope. Required scope: `profiles`"
    }
}

{
    "error": {
        "code": "UNPROCESSABLE_ENTITY",
        "message": "Skin must be a file of type: png"
        "field": "file"
    }
}

{
    "error": {
        "code": "UNPROCESSABLE_ENTITY",
        "message": "Invalid image dimensions"
        "field": "file"
    }
}

{
    "error": {
        "code": "SERVER_ERROR",
        "message": "Something went wrong during skin upload"
    }
}