Поиск скинов по названию

Merchant API v2

Overview

Главное

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

Депозиты

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

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

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

Вывод скинов

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

Другое

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

Поиск скинов по названию

Поиск скинов по названию (market hash name), которые можно вывести. В ответе возвращаются данные о стикерах/чармах/патчах для оружия и агентов (только для CS2).

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

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

method

string

market_search

game

string

'cs2', 'dota2', 'rust'

name

string

Название скина (market hash name)

— ИЛИ —

names

array

Массив из названий скинов (market hash name)

obtained_skin_ids

array

Массив ID скинов для проверки доступности (если указан, name/names не требуются, макс: 100)

limit

int

Максимальное количество результатов (по умолчанию: 50, макс: 1000)

offset

int

Количество результатов для пропуска (по умолчанию: 0)

delivery_types

array

Массив типов доставки: [1], [2] или [1,2]. 1 = Instant, 2 = Slow. По умолчанию: [1,2]

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

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

items

array

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

has_more

bool

Есть ли еще следующие страницы для пагинации

Объект 'items'

int

Skin ID

name

string

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

price

float

Цена скина в USD

classid

string

Class ID скина

delivery_type

int

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

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",
    "items": [
        {
            "id": "2715",
            "name": "SSG 08 | Fever Dream (Field-Tested)",
            "price": "77.02",
            "classid": "3770669160",
            "delivery_type": 1,
            "paint_index": 844,
            "paint_seed": 412,
            "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": "2722",
            "name": "SSG 08 | Fever Dream (Field-Tested)",
            "price": "77.02",
            "classid": "3770669160",
            "delivery_type": 2,
            "paint_index": 844,
            "paint_seed": 90,
            "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
                }
            ]
        }
    ],
    "has_more": true
}

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

missing_required_search_params

Отсутствуют 'name', 'names' или 'obtained_skin_ids'

name_min_length_3

Минимальная длина названия скина 3 символа

max_names_reached

Максимальное кол-во названий - 100

-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