Cennik (dostępność skinów)

Merchant API v2

Overview

Główny

Podstawowe informacje Generowanie podpisu

Depozyty

Pierwsze kroki Tworzenie depozytu Tworzenie depozytu bez przekierowania (iframe) Powiadomienie o wpłacie (webhook) Sprawdzanie statusu depozytu Uzyskanie listy depozytów Depozyty bez 8-dniowego oczekiwania (Steam Trade Protection) Zatwierdzenie depozytu z 8-dniowym holdem Otrzymuj powiadomienia o nieudanych webhookach

Depozyty bez interfejsu użytkownika SkinsBack

Create a deposit without SkinsBack UI (API) Pobierz ekwipunek użytkownika

Wyjście skinów

Cennik (dostępność skinów) Wyszukaj skinów Kup skiny Kupuj skórki hurtowo Stan zakupu skina Historia zakupów skinów Anuluj zakup skina

Inny

Bilans projektu Historia wypłat z salda i depozytów Waluty i kursy Status serwera Zdarzenia w czasie rzeczywistym: websockets Zdarzenia w czasie rzeczywistym: webhooki

Cennik (dostępność skinów)

Metoda zwraca listę dostępnych skinów, które można wyświetlić.

Niebieski podświetla wymagane parametry.

Wyślij żądanie POST do API Endpoint z następującymi parametrami:

method

string

market_pricelist

game

string

'cs2', 'dota2', 'rust'

full

bool

Domyślnie zwracana jest lista rzeczy pogrupowanych według nazw, zawierająca ilość dostępną do wyświetlenia. Jeśli podasz full=1, zwrócona zostanie pełna lista z identyfikatorami pozycji bez grupowania. Zalecane jest użycie listy pogrupowanej.

extended

bool

Domyślnie zwracany jest minimalny zestaw pól w tablicy items. Jeśli podasz extended=1, wówczas zwrócona zostanie tablica z pełniejszymi informacjami dla każdej skiny (tylko razem z full=1).

Uwaga! Rozmiar pliku może być bardzo duży i aby go przetworzyć, użyj bibliotek do wydajnego parsowania JSON (na przykład json-machine dla PHP).

Odpowiedź z serwera:

Jeśli się powiedzie, odpowiedź z serwera będzie zawierać obiekt JSON o następującej treści:

Lista cen zawiera skiny Instant i Slow. Z full=1 każdy item zawiera delivery_type (1 = Instant, 2 = Slow).

last_update

int

Data aktualizacji cennika (czas UNIX)

items

array

Tablica zawierająca listę dostępnych skinów

obiekt 'items'

name

string

Nazwa skina

price

float

Cena skina w USD

classid

string

Class ID skina

count

int

Dostępna Ilość

Pełna struktura 'items' (full=1)

string

ID skina

name

string

Nazwa skina

price

float

Cena skina w USD

classid

string

Class ID skina

delivery_type

int

Typ dostawy: 1 = Instant, 2 = Slow

Rozszerzona struktura 'items' (full=1, extended=1)

paint_index

int / null

Paint Index skina (może być null)

paint_seed

int / null

Paint Seed skina (może być null)

assetid

string / null

Steam asset ID skina (może być null)

source_id

int

ID źródła skina

stickers

array

Naklejki, charms i patche przedmiotu (tylko CS2)

Struktura elementu naklejki

name

string

Nazwa z prefiksem typu (Sticker | ..., Charm | ..., Patch | ...)

img

string

URL obrazu

wear

float / null

Wartość zużycia (może być null)

slot

int / null

Slot (może być null)

Przykład udanej odpowiedzi:

{
    "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
        }
    ]
}

Przykład udanej odpowiedzi (tryb rozszerzony)

Poniższy przykład pokazuje odpowiedź z full=1 i 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": []
        }
    ]
}

Lista możliwych błędów:

file_unavailable

Plik tymczasowo niedostępny

-6

market_disabled

Rynek jest wyłączony

standardowe błędy:

-1

please_use_post_method

Musisz użyć metody POST

-2

invalid_shopid

W systemie nie znaleziono identyfikatora projektu

-3

invalid_signature

Błędnie złożony podpis

-4

shop_not_active

Projekt jest nieaktywny

-5

invalid_method

Nieprawidłowa metoda API

-7

request_limit_reached

Przekroczono limit żądań (500/minutę)

-8

invalid_ip_address

Określ adres IP w ustawieniach projektu

-9

under_maintenance

Witryna w trakcie prac konserwacyjnych

-10

invalid_client_secret

Nieprawidłowy nagłówek X-CLIENT-SECRET