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
Skin kaufen und an Benutzer senden
Skin 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_buy
partner
string
Wert 'partner' aus der Trade-URL des Benutzers
token
string
Wert 'token' aus der Trade-URL des Benutzers
name + game
string + string
Skin-Name (market hash name) + Spiel ('cs2', 'dota2', 'rust')
— ODER —
id
int
Skin-ID aus der Preisliste oder Suche
max_price
float
Maximaler Kaufpreis des Skins (in USD). Wird als Kostenbeschränkung verwendet
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:
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.
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",
"item": {
"id": "2729",
"name": "Glock-18 | Bullet Queen (Battle-Scarred)",
"price": "1591.91",
"classid": "3770702114",
},
"buy_id": 5,
"offer_status": "creating_trade",
"balance_debited_sum": 3000
}
Liste möglicher Fehler:
1
missing_name_and_id
Skin-Name und ID fehlen
2
name_min_length_3
Mindestlänge des Skin-Namens beträgt 3 Zeichen
3
missing_partner_or_token
Parameter 'token' oder 'partner' fehlen
4
insufficient_funds
Unzureichendes Guthaben auf dem Projektkonto
5
skin_unavailable
Skin ist nicht zum Kauf verfügbar
6
skins_not_found_at_specified_price
Es gibt keine Skins mit einem Preis <= 'max_price'
7
custom_id_already_exists
'custom_id' existiert bereits in unserem System
8
invalid_partner_value
Ungültiger Wert für 'partner'
9
invalid_token_value
Falscher Wert für 'token'. Fordern Sie eine neue Handels-URL vom Benutzer an.
10
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.
11
custom_id_already_processing
Eine andere Anfrage mit derselben 'custom_id' wird derzeit verarbeitet. Bitte warten Sie und versuchen Sie es 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