Cilt satın alma ve kullanıcıya gönderme

Ana Sayfa

Temel Bilgiler İmza Oluşturma

Depozitler

Başlarken Depozito Oluşturma Depozito Oluşturma (iframe ile yönlendirme olmadan) Depozito Bildirimi (webhook) Depozito Durumu Kontrolü Depozito Listesi Alma 8 gün beklemesiz yatırımlar (Steam Trade Protection) 8 günlük bekletme ile yatırım onayı Başarısız web kancası bildirimleri alın

SkinsBack kullanıcı arayüzü olmadan para yatırma

Create a deposit without SkinsBack UI (API) Kullanıcının envanterini al

Skin çekme

Fiyat listesi (skin mevcudu) Skin arama Skin satın alma Toplu satın alma skinleri Skin satın alma durumu Skin satın alma geçmişi

Diğer

Proje Bakiyesi Bakiye ve Depozito Çekme Geçmişi Para birimleri ve döviz kurları Sunucu durumu Gerçek zamanlı olaylar: websockets Gerçek zamanlı olaylar: web kancaları

Cilt satın alma ve kullanıcıya gönderme

Cilt satın alma ve onu kullanıcıya gönderme.

Mavi zorunlu parametreleri vurgulanmıştır.

Aşağıdaki parametreleri içeren POST isteği gönderin: API Endpoint

method

string

market_buy

partner

string

Kullanıcının Trade URL'sinden 'partner' değeri

token

string

Kullanıcının Trade URL'sinden 'token' değeri

name + game

string + string

(market hash name) + ('cs2', 'dota2', 'rust') oyununda cilt adı

— VEYA —

int

Fiyat listesinden veya aramadan cilt ID'si

max_price

float

Satın alma için maksimum cilt maliyeti (USD). Bir maliyet sınırlayıcı olarak kullanılır

custom_id

string

Sisteminizdeki benzersiz kimlik. Çift satın almayı önlemek için kullanılır

Sunucudan gelen yanıt:

Başarılı olursa, sunucudan gelen yanıtta aşağıdaki JSON nesnesi olacaktır:

item

object

Satın alınan skin hakkında bilgi içeren bir nesne

— item.id

int

Skin ID

— item.name

string

Skin Adı

— item.price

float

Skinin USD fiyatı

— item.classid

string

Skinin Sınıf ID'si

buy_id

int

Satın alma kimliği, eşya transfer durumunu kontrol etmek için ileride gereklidir

offer_status

string

Satın alma durumu:
1. 'creating_trade' — ticaret oluşturuluyor
2. 'waiting_accept' — ticaret kabul edilmesi bekleniyor
3. 'accepted' — ticaret kabul edildi
4. 'canceled' — ticaret kullanıcı tarafından iptal edildi
5. 'timeout' — ticaret 10 dakika içinde kabul edilmedi
6. 'invalid_trade_token' — geçersiz ticaret token'i
7. 'user_not_tradable' — kullanıcının ticaret sisteminde kısıtlamaları var
8. 'trade_create_error' — ticaret oluşturma hatası (yeniden deneyin)
9. 'rollback_user' — skin kullanıcı tarafından iade edildi (Steam Trade Protection)
10. 'rollback_supplier' — skin tedarikçi tarafından iade edildi (Steam Trade Protection)

Bu yöntem yalnızca create_trade içerebilir. Diğer durumlar market_getinfo / market_history yöntemlerinde kullanılır.

balance_debited_sum

float

Projeden düşülen miktar (USD)

Başarılı yanıt örneği:

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

Mümkün olan hataların listesi:

missing_name_and_id

Cilt adı ve ID eksik

name_min_length_3

Cilt adının minimum uzunluğu 3 karakterdir

missing_partner_or_token

'token' veya 'partner' parametresi eksik

insufficient_funds

Proje bakiyesinde yeterli fon yok

skin_unavailable

Skin satın alınamaz

skins_not_found_at_specified_price

Maliyeti <= 'max_price' olan görünüm yok

custom_id_already_exists

'custom_id' zaten sistemimizde mevcut

invalid_partner_value

'partner' değeri geçersiz

invalid_token_value

'token' değeri geçersiz. Kullanıcıdan yeni Trade URL isteyin

too_many_failed_attempts_for_user

Kullanıcıya skin gönderme işleminde çok sayıda başarısız deneme yapıldı (geçersiz Trade URL, kullanıcı belirtilen sürede skinleri kabul etmiyor, kullanıcının skin takası yapma yeteneği yok). Lütfen daha sonra tekrar deneyin

custom_id_already_processing

Aynı 'custom_id' ile başka bir istek şu anda işleniyor. Lütfen bekleyin ve tekrar deneyin

-6

market_disabled

Pazar kapalı

standart hatalar:

-1

please_use_post_method

POST yöntemi kullanılmalıdır

-2

invalid_shopid

Proje kimliği sistemde bulunamadı

-3

invalid_signature

Geçersiz imza

-4

shop_not_active

Proje etkin değil

-5

invalid_method

Geçersiz API yöntemi

-7

request_limit_reached

İstek sınırı aşıldı (500/dakika)

-8

invalid_ip_address

Proje ayarlarında IP adresini belirtin

-9

under_maintenance

Site bakımda

-10

invalid_client_secret

Geçersiz X-CLIENT-SECRET başlığı