按名称搜索皮肤

Merchant API v2

Overview

主要

基本信息生成签名

存款

入门创建存款创建存款（不带重定向）(iframe) 存款通知（webhook）检查存款状态获取存款列表无需8天等待的存款（Steam交易保护）批准8天冻结期的存款获取失败的 webhook 通知

无SkinsBack用户界面的存款

Create a deposit without SkinsBack UI (API) 获取用户库存

提取皮肤

价格列表（皮肤可用性）搜索皮肤购买皮肤批量购买皮肤购买皮肤的状态皮肤购买历史取消皮肤购买

其他

项目余额余额和存款提现历史记录货币和汇率服务器状态事件实时性：websockets 实时事件：回调

按名称搜索皮肤

通过市场哈希名称搜索可以提取的皮肤。

个蓝色 个必填参数。

向 API终点发送POST请求，使用以下参数：

method

string

market_search

game

string

'cs2', 'dota2', 'rust'

name

string

皮肤的市场哈希名称

— 或 —

names

array

皮肤的市场哈希名称数组

obtained_skin_ids

array

用于检查可用性的皮肤ID数组（如果指定，则不需要name/names，最大：100）

limit

int

最大结果数量（默认：50，最大：1000）

offset

int

要跳过的结果数量（默认：0）

delivery_types

array

delivery_types 数组可为 [1]、[2] 或 [1,2]。1 = Instant，2 = Slow。默认：[1,2]

服务器响应：

如果成功，服务器的响应将是一个JSON对象，内容如下：

items

array

包含可用皮肤列表的数组

has_more

bool

是否还有下一页进行分页

'items'对象

int

皮肤ID

name

string

皮肤名称

price

float

皮肤价格（美元）

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

图片 URL

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 标头

API

按名称搜索皮肤

向 API终点 发送POST请求，使用以下参数：

服务器响应：

'items'对象

贴纸项结构

成功响应示例：

可能的错误列表：

向 API终点发送POST请求，使用以下参数：