Прайс-лист (наличие скинов)

Merchant API v2

Overview

Главное

Основная информация Генерация подписи

Депозиты

Начало работы Создание депозита Создание депозита без переадресации (iframe) Уведомление о депозите (webhook) Проверка статуса депозита Получение списка депозитов Депозиты без 8 дневного ожидания (Steam Trade Protection) Одобрение депозита с 8 дневным холдом Недошедшие уведомления о платежах

Депозиты без SkinsBack UI

Создание депозита без SkinsBack UI (API) Получить инвентарь пользователя

Вывод скинов

Прайс-лист (наличие скинов) Поиск скинов Купить скин Массовая покупка скинов Статус покупки скина История покупок скинов Отмена покупки скина

Другое

Баланс проекта История выводов с баланса и депозитов Валюты и курсы Статус сервера Real-time обновления: WebSockets Real-time обновления: WebHooks

Прайс-лист (наличие скинов)

Метод возвращает список скинов в наличии, которые можно вывести.

Синим выделены обязательные параметры.

Отправьте POST запрос на API Endpoint со следующими параметрами:

method

string

market_pricelist

game

string

'cs2', 'dota2', 'rust'

full

bool

По умолчанию возвращается сгруппированный по названию список вещей, который содержит доступное для вывода количество. Если укажете full=1, то будет возвращен полный список с идентификаторами вещей без группировки. Рекомендуется использовать сгруппированный список.

extended

bool

По умолчанию возвращается минимальный набор полей в массиве items. Если указать extended=1, то будет возвращен массив с более полной информацией по каждому скину (только совместно с full=1).

Внимание! Размер файла может быть очень большой и для его обработки используйте библиотеки для эффективного JSON парсинга (например, json-machine для языка PHP).

Ответ от сервера:

В случае успеха, в ответе от сервера будет объект JSON, со следующим содержанием:

Прайс-лист содержит скины Instant и Slow. При full=1 у каждого item есть delivery_type (1 = Instant, 2 = Slow).

last_update

int

Дата обновления прайс-листа (UNIX время)

items

array

Массив, содержащий список скинов, которые есть в наличии

Объект 'items'

name

string

Название скина

price

float

Цена скина в USD

classid

string

Class ID скина

count

int

Доступное количество

Структура 'items' (full=1)

string

Skin ID

name

string

Название скина

price

float

Цена скина в USD

classid

string

Class ID скина

delivery_type

int

Тип доставки: 1 = Instant, 2 = Slow

Расширенная структура 'items' (full=1, extended=1)

paint_index

int / null

Paint Index скина (может быть null)

paint_seed

int / null

Paint Seed скина (может быть null)

assetid

string / null

Steam asset ID скина (может быть null)

source_id

int

ID источника скина

stickers

array

Стикеры, чармы и патчи предмета (только для CS2)

Структура элемента стикера

name

string

Название с префиксом типа (Sticker | ..., Charm | ..., Patch | ...)

img

string

Ссылка на изображение

wear

float / null

Износ (может быть null)

slot

int / null

Слот (может быть null)

Пример успешного ответа:

{
    "status": "success",
    "last_update": "1596621504",
    "items": [
        {
            "name": "M4A1-S | Golden Coil (Battle-Scarred)",
            "price": "831.16",
            "count": 1
        },
        {
            "name": "SSG 08 | Fever Dream (Field-Tested)",
            "price": "77.02",
            "count": 2
        },
        {
            "name": "Operator | FBI SWAT",
            "price": "77.76",
            "count": 1
        }
    ]
}

Пример успешного ответа (расширенный режим)

Ниже приведен пример ответа с параметрами full=1 и extended=1.

{
    "status": "success",
    "last_update": "1596621504",
    "items": [
        {
            "id": "771502",
            "name": "M4A1-S | Golden Coil (Battle-Scarred)",
            "price": "831.16",
            "classid": "3020283907",
            "delivery_type": 1,
            "paint_index": 426,
            "paint_seed": 661,
            "assetid": "41234567890",
            "source_id": 1,
            "stickers": [
                {
                    "name": "Sticker | FaZe Clan (Gold) | Shanghai 2024",
                    "img": "https://cdn.steamstatic.com/apps/730/icons/econ/stickers/rmr2020/faze_gold.png",
                    "wear": 0,
                    "slot": 0
                },
                {
                    "name": "Charm | Die-cast AK",
                    "img": "https://cdn.steamstatic.com/apps/730/icons/econ/keychains/weapon_1/kc_wpn_ak_jelly.png",
                    "wear": 0,
                    "slot": null
                }
            ]
        },
        {
            "id": "771503",
            "name": "Operator | FBI SWAT",
            "price": "77.76",
            "classid": "4699526876",
            "delivery_type": 2,
            "paint_index": null,
            "paint_seed": null,
            "assetid": "41234567891",
            "source_id": 2,
            "stickers": [
                {
                    "name": "Patch | Howl Patch",
                    "img": "https://cdn.steamstatic.com/apps/730/icons/econ/patches/howl.png",
                    "wear": 0,
                    "slot": null
                }
            ]
        },
        {
            "id": "771504",
            "name": "SSG 08 | Fever Dream (Field-Tested)",
            "price": "77.02",
            "classid": "3770669160",
            "delivery_type": 1,
            "paint_index": 844,
            "paint_seed": 412,
            "assetid": "41234567892",
            "source_id": 1,
            "stickers": []
        }
    ]
}

Список возможных ошибок:

file_unavailable

Файл временно недоступен

-6

market_disabled

Маркет выключен

стандартные ошибки:

-1

please_use_post_method

Необходимо использовать POST метод

-2

invalid_shopid

ID проекта не найден в системе

-3

invalid_signature

Неверно сформирована подпись

-4

shop_not_active

Проект неактивен

-5

invalid_method

Неверный API метод

-7

request_limit_reached

Превышен лимит запросов (500/в минуту)

-8

invalid_ip_address

Укажите IP адрес в настройках проекта

-9

under_maintenance

Сайт на обслуживании

-10

invalid_client_secret

Неверный передан заголовок X-CLIENT-SECRET