Skin-Kaufverlauf

Merchant API v2

Overview

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 Skin-Kauf stornieren

Sonstiges

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

Skin-Kaufverlauf

Informationen zu allen gekauften Gegenständen. Ausgabe auf 1000 begrenzt.

Blaue markiert obligatorische Parameter.

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

method

string

market_history

starting

int

UNIX-Zeitpunkt des Beginns der Abfrage

ending

int

UNIX-Zeitpunkt zum Ende der Auswahl

start_from

int

start_from-Parameter aus der Antwort zum Navigieren durch die Seiten (die Anzahl der Ergebnisse ist auf 1000 begrenzt)

Antwort vom Server:

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

total_count

int

Gesamtzahl der Ergebnisse (die Anzahl der Ergebnisse ist auf 1000 begrenzt)

has_more

bool

Gibt es weitere Seiten für die Paginierung

start_from

int

Wird für die Navigation durch die Seiten verwendet

items

array

Array mit den unten beschriebenen Elementen

Objekt 'items'

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.delivery_type

int

Lieferart: 1 = Instant, 2 = Slow

— item.classid

string

Class ID des Skins

buy_id

int

ID der Skin-Kauf

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)

in_hold

bool

Ob der Skin in Hold ist oder nicht

in_hold_until

string (datetime)

Datum, bis zu dem der Skin in Hold ist (wenn der Skin in Hold ist)

error_reason

string

Grund (falls vorhanden):
1. 'user_cant_trade' – für den Benutzer besteht eine Handelsbeschränkung bei Steam
2. 'private_inventory' – Benutzer muss Inventar öffnen
3. 'user_trade_ban' – Benutzer hat Handelsverbot
4. 'user_inventory_is_full' – das Inventar des Benutzers ist voll
5. 'too_many_failed_attempts' - zu viele fehlgeschlagene Auszahlungsversuche für den Benutzer
6. 'skin_unavailable' – Skin nicht käuflich (oder verkauft)
7. 'p2p_purchase_canceled_by_user' – P2P-Kauf wurde vom Benutzer storniert
8. 'p2p_purchase_canceled_by_system' – P2P-Kauf wurde automatisch vom System storniert

steamid

string

Steam ID des Benutzers

date

int

Kaufdatum (UNIX-Zeit)

balance_debited_sum

float

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

tradeofferid

string

Trade Offer ID in Steam (nur vorhanden, wenn ein Handel erstellt wurde)

custom_id

string

'custom_id' in Ihrem System

refund_percent @deprecated

int

Rücklaufquote für Rollbacks aufgrund von Benutzerfehlern. Veraltet: refund_amount verwenden

refund_amount

string|null

Tatsächlicher Erstattungsbetrag bei Rollback

Beispiel für eine erfolgreiche Antwort:

{
    "status": "success",
    "items": [
        {
            "item": {
                "id": "2713",
                "name": "AWP | Man-o'-war (Minimal Wear)",
                "price": "1325.61",
                "classid": "3496732101",
                "instanceid": "480085569"
            },
            "tradeofferid": "4169974564",
            "buy_id": "2",
            "offer_status": "user_not_tradable",
            "error_reason": "private_inventory",
            "steamid": "76561198050648523",
            "date": "1596623088",
            "refund_percent": 70,
            "refund_amount": null
        },
        {
            "item": {
                "id": "2713",
                "name": "AWP | Man-o'-war (Minimal Wear)",
                "price": "1325.61",
                "classid": "3496732101",
                "instanceid": "480085569"
            },
            "tradeofferid": "4169977670",
            "buy_id": "3",
            "offer_status": "canceled",
            "error_reason": null,
            "steamid": "76561198050648523",
            "date": "1596623246",
            "refund_percent": 70,
            "refund_amount": null
        },
    ],
    "total_count": "2000",
    "has_more": true,
    "start_from": 999
}

Liste möglicher Fehler:

missing_starting_or_ending

Es fehlt das UNIX-Start- oder Enddatum

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