Zakup hurtowy skórek i wysłanie do użytkownika

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

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

Zakup hurtowy skórek i wysłanie do użytkownika

Zakup hurtowy skórek i wysłanie ich użytkownikowi.

Niebieski podświetla wymagane parametry.

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

method

string

market_batch_buy

partner

string

Wartość 'partner' z Trade URL użytkownika

token

string

Wartość 'token' z Trade URL użytkownika

items

array

Tablica przedmiotów do zakupu skórek

items[][id]

int

ID skina z cennika lub wyszukiwania

items[][max_price]

float

Maksymalny koszt zakupu skina (w USD). Stosowany jako ogranicznik kosztów

items[][custom_id]

string

Unikalny identyfikator w systemie. Służy do zapobiegania podwójnemu zakupowi

Odpowiedź z serwera:

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

purchased

array

Tablica zawierająca listę zakupionych skórek, opis poniżej

unavailable

array

Tablica zawierająca listę niedostępnych identyfikatorów skórek i powodów:
- insufficient_funds (error_code: 4) — Niewystarczające środki w saldzie projektu
- skin_unavailable (error_code: 5) — Skin nie można kupić
- skins_not_found_at_specified_price (error_code: 6) — Nie ma skinów, których koszt wynosi <= 'max_price'
- custom_id_already_exists: (error_code: 7) — 'custom_id' już istnieje w naszym systemie

Tablica 'purchased'

item

object

Obiekt zawierający informację o zakupionej skina

— item.id

int

ID skina

— item.name

string

Nazwa skina

— item.price

float

Cena skina w USD

— item.classid

string

Class ID skina

buy_id

int

ID zakupu, wymagany później w celu sprawdzenia statusu przekazania przedmiotu

offer_status

string

Status zakupu:
1. 'creating_trade' - trwa tworzenie giełdy
2. 'waiting_accept' - wymiana oczekuje na akceptację
3. 'accepted' - wymiana zaakceptowana
4. 'canceled' - wymiana odrzucona przez użytkownika
5. 'timeout' - wymiana nie została przyjęta w ciągu 10 minut
6. 'invalid_trade_token' - nieprawidłowy trade token
7. 'user_not_tradable' - użytkownik ma ograniczenia w systemie giełdowym
8. 'trade_create_error' - błąd podczas tworzenia giełdy (spróbuj ponownie)
9. 'rollback_user' — skin został zwrócony przez użytkownika (Ochrona Transakcji Steam)
10. 'rollback_supplier' — skin został zwrócony przez dostawcę (Ochrona Transakcji Steam)

Ta metoda może zawierać tylko plik create_trade. Pozostałe statusy znajdują się w metodach market_getinfo / market_history.

balance_debited_sum

float

Kwota odpisana z salda projektu (USD)

Przykład udanej odpowiedzi:

{
   "status":"success",
   "purchased":{
      "62696971":{
         "item":{
            "id":"62696971",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.28,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112705,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.28,
         "custom_id":"10000"
      },
      "62697425":{
         "item":{
            "id":"62697425",
            "name":"'The Doctor' Romanov | Sabre",
            "price":8.03,
            "classid":"3608084106",
            "instanceid":"0"
         },
         "buy_id":129112706,
         "offer_status":"creating_trade",
         "steamid":"76561198050648523",
         "date":"1748862060",
         "balance_debited_sum":8.03,
         "custom_id":"10001"
      }
   },
    "unavailable":{
      "62696979":{
         "error_code":5,
         "error_message":"skin_unavailable"
      },
      "62697480":{
         "error_code":5,
         "error_message":"skin_unavailable"
      }
   }
}

Lista możliwych błędów:

invalid_partner_value

Nieprawidłowa wartość 'partner'

invalid_token_value

Nieprawidłowa wartość 'token'. Poproś użytkownika o Trade URL

too_many_failed_attempts_for_user

Zbyt wiele niepowodzeń przy wysyłaniu skinów do użytkownika (nieprawidłowy Trade URL, użytkownik nie przyjmuje skinów w danym terminie, użytkownik nie ma możliwości wymiany skinów). Spróbuj później

-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