quick buy item - CS2DT饰品开放平台

If you purchase a single item using the market_hash_name in the sales list interface, the purchase may encounter error codes enum in Status. The error codes generated by the purchase may be described in the response code below

To support switching between Chinese and English, you need to add a parameter named "language" with the value "en_US" in the request header. This will allow you to receive English information responses for purchase failure scenarios.
response code:106505 user’s steam account can’t trade
response code:140005 wrong trade url format
response code:106509 user’s steam account’s inventory is private
response code:106310 user’s steam’s steam trade url is invalid
response code:106516 user’s steam open the steam family view
response code:106517 user’s steam locked by steam
response code:106006 user’s steam was vac by steam
response code:70001 balance is not enough
response code:1367 This Steam account has been temporarily restricted from making purchases due to repeated non-receipt or refusal of purchase orders in the past 12 hours. This restriction will be lifted after 'n' hours
response code: 140024 The merchant order is currently being processed. Please wait for a callback or tocheck for updates after 1 minute.
response code: 140014 The merchant order number already exists.
response code: 1369 The Steam account was tagged for fraudulent activities and cannot make purchases.
response code: 105001 Item sold or removed already.
response code: 1708 You passed a wrong price parameter!
response code: 1317 No items for sale met the specified criteria.
response code: 1014452 The item has been unlisted by seller.
response code: 103011 The Steam account is unable to trade. You can check the specific error reason in the "errorData" field.
response code: 70001 Insufficient balance
response code: 1454 The market price of the item exceeds the maximum purchase price.
response code: 1403 The item price has changed. Please proceed with a new purchase.
response code: 1207 The item has been sold or removed!
response code: 100000 Server error!
response code: 1363 Server error! Purchase failed
response code: 201445 A purchase exception has left the payment status unknown. Please wait for a callback or to check for updates after 1 minute.
response code: 1010324 This trade link is invalid and cannot be used. Please ask the buyer to update the link.

请求参数

Query 参数

app-key

string

可选

默认值:

Body 参数application/json

quick buy params

outTradeNo

string | null

必需

The merchant order number must be unique

tradeUrl

string | null

必需

Buyer steam tradeUrl

itemId

integer | null

Item ID

可选

appId

integer | null

Game ID

可选

marketHashName

string | null

可选

steam_market_hash_name

maxPrice

number | null

必需

If price field is provided we are going to purchase item with the same or lower price

delivery

integer | null

可选

Delivery mode 1-manual 2-auto

lowPrice

integer | null

可选

Whether to automatically ship quotes；
Quick buy whether to buy the lowest price, if it is 1, buy the lowest price, if not, adopt the default policy, check all the items less than maxPrice on sale, if these in the sale have automatic shipping, then select the cheapest automatic shipping, if there is no automatic shipping, will go to choose the cheapest thing

示例

{
    "outTradeNo": "string",
    "tradeUrl": "string",
    "itemId": 0,
    "appId": 0,
    "marketHashName": "string",
    "maxPrice": 0,
    "delivery": 0,
    "lowPrice": 0
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

购买结果

success

boolean | null

可选

Is request successful

data

object

可选

Business data

buyPrice

number | null

可选

Actual payment

orderId

string | null

orderId

可选

delivery

integer | null

可选

method 1-manual 2-auto

offerId

string | null

可选

errorCode

integer | null

可选

Error code

errorMsg

string | null

可选

Error message

errorData

object (Object)

可选

Error data,when errorCode is not equals to 0,maybe this property will have a value

示例

{
  "success": false,
  "data": {
    "buyPrice": 0.0,
    "orderId": "",
    "delivery": 0,
    "offerId": ""
  },
  "errorCode": 0,
  "errorMsg": "",
  "errorData": {}
}