Skins in großen Mengen kaufen und an den Benutzer senden

Hauptseite

Hauptinformationen Generierung der Unterschrift

Einzahlungen

Erste Schritte Depot erstellen Depot erstellen ohne Weiterleitung (iframe) Benachrichtigung über Einzahlung (webhook) Überprüfung des Einzahlungsstatus Abrufen der Liste der Einlagen Einzahlungen ohne 8-tägige Wartezeit (Steam Trade Protection) Einzahlungsgenehmigung mit 8-tägigem Hold Benachrichtigungen zu fehlgeschlagenen Webhooks erhalten

Einzahlungen ohne SkinsBack UI

Create a deposit without SkinsBack UI (API) Inventar des Benutzers abrufen

Skin-Abhebung

Preisliste (Skin-Verfügbarkeit) Skin-Suche Skin kaufen Skins in großen Mengen kaufen Status des Skin-Kaufs Kaufverlauf für Skins

Sonstiges

Projektsaldo Auszahlungs- und Einzahlungshistorie Währungen und Wechselkurse Serverstatus Ereignisse in Echtzeit: Websockets Ereignisse in Echtzeit: Webhook

Skins in großen Mengen kaufen und an den Benutzer senden

Skins in großen Mengen kaufen und an den Benutzer senden.

Blaue markiert obligatorische Parameter.

Senden Sie eine POST-Anfrage an den API-Endpunkt mit den folgenden Parametern:

method

string

market_batch_buy

partner

string

Wert 'partner' aus der Trade-URL des Benutzers

token

string

Wert 'token' aus der Trade-URL des Benutzers

items

array

Array mit Artikeln zum Kauf von Skins

items[][id]

int

Skin-ID aus der Preisliste oder Suche

items[][max_price]

float

Maximaler Kaufpreis des Skins (in USD). Wird als Kostenbeschränkung verwendet

items[][custom_id]

string

Eindeutige ID in Ihrem System. Wird verwendet, um Doppelkäufe zu verhindern

Antwort vom Server:

Bei Erfolg enthält die Antwort vom Server ein JSON-Objekt mit folgendem Inhalt:

purchased

array

Array mit einer Liste der gekauften Skins (Beschreibung siehe unten)

unavailable

array

Array mit einer Liste nicht verfügbarer Skin-IDs und den entsprechenden Gründen:
- insufficient_funds (error_code: 4) — Unzureichendes Guthaben auf dem Projektkonto
- skin_unavailable (error_code: 5) — Skin ist nicht zum Kauf verfügbar
- skins_not_found_at_specified_price (error_code: 6) — Es gibt keine Skins mit einem Preis <= 'max_price'
- custom_id_already_exists: (error_code: 7) — 'custom_id' existiert bereits in unserem System

Array mit 'purchased'

item

object

Objekt, das Informationen über den gekauften Skin enthält

— item.id

int

Skin-ID

— item.name

string

Skin-Name

— item.price

float

Skin-Preis in USD

— item.classid

string

Class ID des Skins

buy_id

int

ID des Kaufs, wird später zur Überprüfung des Übertragungsstatus des Gegenstands benötigt

offer_status

string

Kaufstatus:
1. 'creating_trade' — Handel wird erstellt
2. 'waiting_accept' — Handel wartet auf Annahme
3. 'accepted' — Handel angenommen
4. 'canceled' — Handel vom Benutzer abgelehnt
5. 'timeout' — Handel nicht innerhalb von 10 Minuten angenommen
6. 'invalid_trade_token' — ungültiges Handelstoken
7. 'user_not_tradable' — Benutzer hat Einschränkungen im Handelssystem
8. 'trade_create_error' — Fehler beim Erstellen des Handels (bitte erneut versuchen)
9. 'rollback_user' — Skin wurde vom Benutzer zurückgegeben (Steam Trade Protection)
10. 'rollback_supplier' — Skin wurde vom Lieferanten zurückgegeben (Steam Trade Protection)

Diese Methode kann nur create_trade enthalten. Andere Status in den Methoden market_getinfo / market_history.

balance_debited_sum

float

Betrag, der vom Projekt-Guthaben abgezogen wurde (USD)

Beispiel für eine erfolgreiche Antwort:

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

Liste möglicher Fehler:

invalid_partner_value

Ungültiger Wert für 'partner'

invalid_token_value

Falscher Wert für 'token'. Fordern Sie eine neue Handels-URL vom Benutzer an.

too_many_failed_attempts_for_user

Zu viele fehlgeschlagene Versuche beim Senden von Skins an den Benutzer (falsche Handels-URL, Benutzer akzeptiert Skins nicht zur angegebenen Zeit, Benutzer kann keine Skins tauschen). Versuchen Sie es später erneut.

-6

market_disabled

Markt deaktiviert

Standardfehler:

-1

please_use_post_method

Es muss die POST-Methode verwendet werden

-2

invalid_shopid

Projekt-ID wurde nicht im System gefunden

-3

invalid_signature

Ungültige Signatur

-4

shop_not_active

Projekt ist inaktiv

-5

invalid_method

Ungültige API-Methode

-7

request_limit_reached

Anfrage-Limit überschritten (500/Minute)

-8

invalid_ip_address

Geben Sie die IP-Adresse in den Projekteinstellungen an

-9

under_maintenance

Website in Wartung

-10

invalid_client_secret

Ungültiger X-CLIENT-SECRET-Header