Youyou Youpin Open Platform

https://www.yuque.com/yyyoupin/azx6iu
Admin
Youyou Youpin Open Platform is an open API platform that provides interfaces for marketplace...
Tokens:103,709
Snippets:236
Trust Score:9.7
Update:10 months ago
Show doc for...
Tokens:
Raw
### Request Example for User On-Sale List

Source: https://www.yuque.com/yyyoupin/azx6iu/mw73n89f80gdnsrn_language=en-us

This is an example of a JSON request body used to query the user's on-sale list. It includes essential parameters such as appKey, timestamp, sign, steamId, and optional pagination parameters page and pageSize.

```json
{
"appKey":"1000", 
"timestamp":"2023-10-02 12:10:10"
"sign":"xxxxxxxxxxx"
"steamId":"10022333000", 
"page":1,
"pageSize":20
}
```

--------------------------------

### Request Example for Query Seller Order List

Source: https://www.yuque.com/yyyoupin/azx6iu/pkekqs84kz8y0l0r_language=zh-cn

This JSON object demonstrates a sample request payload for querying the seller order list. It includes parameters like start and end times, order status, pagination details, appKey, timestamp, and the signature for authentication. The parameters are crucial for filtering and authenticating the request.

```json
{
"startTime":"2023-08-13 16:39:00",
"endTime":"2023-10-13 16:39:00",
"bigStatus":280,
"pageIndex":1,
"pageSize":10,
"appKey":"123456",
"timestamp":"2023-10-13 17:28:50",
"sign":"nNnq9PPHk3UQCFY/Bg99Os8pWUgT6bAMZwWF8HJWJQeeeeee5Wo3cR3auYthileAfn0beLp1nu9musI122vd6A/8/pog=="
}
```

--------------------------------

### Python API Signing and Calling

Source: https://www.yuque.com/yyyoupin/azx6iu/vshk4xof6c2lus77_language=zh-cn

This section provides examples for signing data and calling APIs using Python. It highlights the process of generating a signature for API requests and demonstrates a basic API call. It assumes the existence of utility functions for signing and request execution.

```python
# Python签名
# Python调用接口demo
```

--------------------------------

### Python API Call Demo

Source: https://www.yuque.com/yyyoupin/azx6iu/vshk4xof6c2lus77_language=en-us

This Python script serves as a demonstration for making API calls. It includes example code for interacting with external services, potentially for testing or integration purposes. The provided snippet is a basic template and may require further implementation based on specific API requirements.

```python
# -*- coding: UTF-8 -*-
"""
# ---------------------------------------
# @DateTime : 2022/12/5 8:11 PM
# @Author : youpin
# @Email :
# PyCharm
# @Description : 生成rsa2加密后的sign值
"""

```

--------------------------------

### Request Example: Query Product Template ID

Source: https://www.yuque.com/yyyoupin/azx6iu/axoult0l2yxrxm9n_language=zh-cn

This JSON snippet demonstrates a sample request to the templateQuery API. It includes common request parameters such as sign, timestamp, and appKey required for authentication and processing.

```json
{
"sign":"GgXAWmcFWIANiJFRDy6GF+1MruDZPgoA2FRZAlLn9wHy8guc5dBm8tW/080kY4LzTCyu9puLRVol+eWJuYPCLtTTmcdj/0OY0U9dNyL4S2M1B5fhzezyCtT/CE5/5icNkQ8YFh3z8Z+RXeFg4qHyuQ/pUhgSJMDrNguJOm1on42FhEDDu7rcmwQnn4mvSDQKUc6t+Sc/q+hnqv1++YbkA8olsIv6f8a2xYQDGkSve0Y37HnjZx2DOpyMuWGrxSQmkhNee0VMXf8lFclVtivL0o326w2yssSYy5P6/q8Arn+TqZveP/9w/sohFTpf0WS4O7zz+5o8ImPTA6NJ78qmVQ==",
"timestamp":"2022-11-24 22:23:00",
"appKey":"123456"
}
```

--------------------------------

### Successful Response Example API

Source: https://www.yuque.com/yyyoupin/azx6iu/uk8ch0agxzn3grga

Provides an example of a successful response from an API, likely related to trade offers or commodity information.

```APIDOC
## GET /api/response/example

### Description
This endpoint returns a sample successful response, illustrating the structure of trade offer and commodity information.

### Method
GET

### Endpoint
/api/response/example

### Parameters
None

### Request Example
None

### Response
#### Success Response (200)
- **code** (integer) - The status code of the response (0 indicates success).
- **msg** (string) - A message describing the response status (e.g., 'Success').
- **timestamp** (integer) - The Unix timestamp of when the response was generated.
- **data** (object) - Contains the main response data.
  - **tradeOffer** (object) - Information about a trade offer.
    - **tradeOfferId** (string) - The unique identifier for the trade offer.
    - **tradeOfferStatus** (integer) - The current status of the trade offer.
    - **sendOfferSuccessTime** (string) - Timestamp for when the offer was successfully sent.
    - **sendOfferEndTime** (string) - Timestamp for when the offer sending ended.
    - **confirmOfferEndTime** (string) - Timestamp for when the offer confirmation ended.
  - **commodityInfos** (array) - A list of commodity items.
    - **commodityId** (integer) - The unique identifier for the commodity.
    - **commodityName** (string) - The name of the commodity.
    - **commodityPrice** (string) - The price of the commodity.
    - **itemInfo** (object) - Detailed information about the item.
      - **buzhangs** (integer) - Number of 'buzhangs' (specific item attribute).
      - **stickers** (integer) - The number of stickers on the item.
      - **itemStickers** (array) - A list of stickers applied to the item.
        - **stickerId** (integer) - The unique identifier for the sticker.
        - **rawIndex** (integer) - The index of the sticker in its original format.
        - **name** (string) - The name of the sticker.
        - **imgUrl** (string) - The URL of the sticker image.
        - **hashName** (string) - The hash name of the sticker.
        - **abrade** (string) - The abrasion value of the sticker.

#### Response Example
```json
{
  "code": 0,
  "msg": "Success",
  "timestamp": 1697189546663,
  "data": {
    "tradeOffer": {
      "tradeOfferId": "11111111",
      "tradeOfferStatus": 3,
      "sendOfferSuccessTime": "1697120108000",
      "sendOfferEndTime": "1697120701000",
      "confirmOfferEndTime": "1697163308000"
    },
    "commodityInfos": [
      {
        "commodityId": 2233333,
        "commodityName": "PP-Wild Buffalo (Souvenir) | Lethal Spray (Battle-Scarred)",
        "commodityPrice": "7",
        "itemInfo": {
          "buzhangs": 0,
          "stickers": 4,
          "itemStickers": [
            {
              "stickerId": 1111,
              "rawIndex": 0,
              "name": "Mirage (Gold)",
              "imgUrl": "https://youpin.img898.com/apps/730/icons/econ/stickers/tournament_assets/de_mirage_gold.9edfd0e55b7cc35978d9deff5bad9d68ab407f12.png",
              "hashName": "Mirage (Gold)",
              "abrade": "100"
            },
            {
              "stickerId": 2222,
              "rawIndex": 1,
              "name": "Team Spirit (Gold) | Antwerp 2022",
              "imgUrl": "https://youpin.img898.com/economy/image/03a53df38e594b119ff67bb4c601de03.png",
              "hashName": "Team Spirit (Gold) | Antwerp 2022",
              "abrade": "100"
            }
          ]
        }
      }
    ]
  }
}
```
```

--------------------------------

### Fast Purchase by Template (Async V2)

Source: https://www.yuque.com/yyyoupin/azx6iu/tto20cgq3gfaam02_language=zh-cn

Allows developers to quickly purchase specified templates (only items with no wear and tear are supported) by placing an order. This API is faster than the synchronous interface, locks the lowest price item less than or equal to the purchase price within 5 seconds, and asynchronously verifies the transaction link and payment, thereby increasing order frequency and reducing purchase costs.

```APIDOC
## POST /open/v1/api/byTemplateAsyncCreateOrderV2

### Description
Allows developers to quickly purchase specified templates (only items with no wear and tear are supported) by placing an order. This API is faster than the synchronous interface, locks the lowest price item less than or equal to the purchase price within 5 seconds, and asynchronously verifies the transaction link and payment, thereby increasing order frequency and reducing purchase costs.

### Method
POST

### Endpoint
https://gw-openapi.youpin898.com/open/v1/api/byTemplateAsyncCreateOrderV2

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **merchantOrderNo** (String) - Required - Merchant order number. Can be a numeric or alphanumeric string up to 59 characters.
- **tradeLinks** (String) - Required - Steam trade link of the recipient.
- **commodityTemplateId** (String) - Required - Commodity template ID. Source: Query Template ID. Mutually exclusive with `commodityHashName`. If both are provided, `commodityTemplateId` takes precedence. Cannot be 0.
- **commodityHashName** (String) - Required - Template hash name. Source: Query Template ID. Mutually exclusive with `commodityTemplateId`. Cannot be empty.
- **purchasePrice** (String) - Required - Highest purchase price. Unit: Yuan. Cannot be 0.
- **fastShipping** (Integer) - Optional - Fast shipping purchase mode. 0: Prioritize fast shipping; 1: Only purchase fast shipping.

### Request Example
```json
{
  "sign": "4LL1O++Btn5JgZ6kHuJAN7dEG4cgLd0goo+Cb4wld0ygpU8lU+73mLxXYtN81ApAhWuw9zn+ENrtc2KcrL6XgHMSG8JC/5NjHCGO/3jDUjAac3YMh5vdQjsqhK1IoxdrOXM9QUyUj2kU9CA4eRey5wBx+BjbzHkSXXt6tOk9pDkeg56wuKR9L3g1BldcwBEacW2fU4pfEW9vpJC9QTCU/FAT0JXMTpYOaeIn+uf9eQRlRNguI1eUoWJAiGQgVQ/TlFlkdVqeE0pHp3Ntod2r+pkb4vCKrMDI6HW28XsM0uMupOfBUL8zRNFEOvLtswJduVo5r5Fd1ysHFcFywHOT0A==",
  "timestamp": "2023-01-17 17:59:00",
  "appKey": "123456",
  "merchantOrderNo": "20230112000",
  "tradeLinks": "https://steamcommunity.com/tradeoffer/new/?partner=123456&token=vP12QeQA",
  "commodityTemplateId": "100696",
  "commodityHashName": "",
  "purchasePrice": "0.08"
}
```

### Response
#### Success Response (200)
- **code** (Integer) - Response code. 0 for success.
- **msg** (String) - Response message. "成功" for success.
- **timestamp** (Long) - Timestamp of the response.
- **data** (Object) - Response body.
  - **merchantOrderNo** (String) - Merchant order number.
  - **orderNo** (String) - Youpin order number.
  - **shippingMode** (Integer) - Shipping mode: 0, Seller direct shipping; 1, Fast shipping.
  - **commodityPrice** (BigDecimal) - Commodity price. Unit: Yuan.
  - **status** (String) - Order status: 120, Pending payment.

#### Response Example
```json
{
  "code": 0,
  "msg": "成功",
  "timestamp": 1673943192928,
  "data": {
    "merchantOrderNo": "20230112102",
    "orderNo": "2023011710002994746",
    "commodityPrice": "0.08",
    "status": "120"
  }
}
```

### Error Codes
- **5201**: Trading function of this account is banned. Please contact customer service.
- **5202**: The purchasing target is temporarily restricted from purchasing due to multiple instances of not receiving or rejecting orders in the past 12 hours. This restriction will be lifted after %s.
- **5212**: Insufficient balance. Please ensure sufficient balance before creating an order.
- **5213**: No items available within this price limit.
- **5214**: No items on sale currently. Please choose other items.
- **5301**: The item status has changed and cannot be purchased. Please choose other items.
- **5299**: Cannot purchase.
- **5408**: Incorrect format for the trading link of the purchasing target.
```

--------------------------------

### Query Order Status Request Example

Source: https://www.yuque.com/yyyoupin/azx6iu/qfbnrlo6f947cw93

This is an example of a POST request to the orderStatus API endpoint. It includes common parameters like sign, timestamp, appKey, and either orderNo or merchantNo.

```json
{
"sign":"048KgY1HV73I/sUmzdaSipONvf2OHeFBAAUKkx/mT7O1YGtWPK6UNVRAeSsrp+jzdAgxY6l7FrJEolhKfCQm68MwiZ50al8nHkRLRBKk4TZkWJQB93KHQREUtdUf/G1DuquDXB5SizKhflvDiL+sLf9IZPfWU4esBTeRVQyDgGOLSZNs2tzGctpr/ykXEB0sNwVoK2SNnpQ7HxvIBGFxqOVZKtjT5elYiAWaHXqfit3klX4uTiaytRgxLaAFYX8B8FvszHqjvoNhVs2Zt8bztJIKet84Ga0dBbBZ3DB9t1HAxSwNfmYQBAYWCCnRFWYwMPOrsJd+mtXrogH10AkKHw==",
"timestamp":"2022-11-24 21:49:00",
"appKey":"123456",
"orderNo":"2022112410000103036"
}
```

--------------------------------

### POST /open/v1/api/byTemplateCreateOrderV2

Source: https://www.yuque.com/yyyoupin/azx6iu/mrnu2rbczv7ng6p6

This endpoint allows developers to purchase items from a specified template. It supports purchasing items with no wear and tear, and selects the lowest priced item that is less than or equal to the maximum purchase price.

```APIDOC
## POST /open/v1/api/byTemplateCreateOrderV2

### Description
This endpoint allows developers to purchase items from a specified template. It supports purchasing items with no wear and tear, and selects the lowest priced item that is less than or equal to the maximum purchase price.

### Method
POST

### Endpoint
https://gw-openapi.youpin898.com/open/v1/api/byTemplateCreateOrderV2

### Parameters
#### Request Body
- **merchantOrderNo** (String) - Required - Merchant order number, a string up to 59 characters.
- **tradeLinks** (String) - Required - The Steam trade link of the recipient.
- **commodityTemplateId** (String) - Required - Commodity template ID. Data source: Query Template ID. Either `templateId` or `hashName` must be provided. If both are provided, `templateId` takes precedence. Cannot be 0.
- **commodityHashName** (String) - Required - Template hash name. Data source: Query Template ID. Either `templateId` or `hashName` must be provided. If both are provided, `templateId` takes precedence. Cannot be empty.
- **purchasePrice** (String) - Required - Maximum purchase price in Yuan. Cannot be 0.
- **fastShipping** (Integer) - Optional - Fast shipping purchase mode. 0: Prioritize fast shipping; 1: Only purchase fast shipping.

### Request Example
```json
{
  "merchantOrderNo": "your_merchant_order_no",
  "tradeLinks": "your_steam_trade_link",
  "commodityTemplateId": "template_id_if_available",
  "commodityHashName": "hash_name_if_template_id_not_available",
  "purchasePrice": "10.50",
  "fastShipping": 0
}
```

### Response
#### Success Response (200)
- **data** (Object) - Response message body.
  - **merchantOrderNo** (String) - Merchant order number.
  - **orderNo** (String) - Order number.
  - **ShippingMode** (Integer) - Shipping mode: 0, Seller direct shipping; 1, Fast shipping.
  - **payAmount** (number) - Actual payment amount.
  - **orderStatus** (Integer) - Transaction status: 0, Success; 2, Failure.

#### Response Example
```json
{
  "data": {
    "merchantOrderNo": "your_merchant_order_no",
    "orderNo": "generated_order_no",
    "ShippingMode": 1,
    "payAmount": 10.50,
    "orderStatus": 0
  }
}
```

### Error Codes
- **5201**: The account's transaction function is banned. Please contact customer service.
- **5202**: The recipient has had multiple instances of not receiving or rejecting orders in the past 12 hours, and is temporarily restricted from purchasing. This restriction will be lifted after %s.
- **5212**: Insufficient balance. Please ensure sufficient balance before creating an order.
- **5213**: No items available within this price limit.
- **5214**: No items currently for sale. Please select other items.
- **5301**: Item status has changed, cannot purchase at this time. Please select other items.
- **5299**: Cannot purchase.
- **5401**: Steam network anomaly.
- **5402**: Please try again later.
- **5403**: The recipient's Steam account cannot trade at this time.
- **5404**: The recipient's Steam account is banned and cannot trade.
- **5405**: The recipient's trade link has expired.
- **5406**: The recipient's Steam inventory is not public and cannot trade.
- **5407**: Cannot input your own trade link.
- **5408**: The recipient's trade link format is incorrect.
```

--------------------------------

### Request Example for Verifying Transaction Link (JSON)

Source: https://www.yuque.com/yyyoupin/azx6iu/dyfvf1yb4mkhlulp_language=en-us

This is an example of a JSON request payload used to verify a transaction link. It includes authentication details like appKey and sign, along with the transaction link itself and a timestamp.

```json
{
"sign":"4LL1O++Btn5JgZ6kHuJAN7dEG4cgLd0goo+Cb4wld0ygpU8lU+73mLxXYtN81ApAhWuw9zn+ENrtc2KcrL6XgHMSG8JC/5NjHCGO/3jDUjAac3YMh5vdQjsqhK1IoxdrOXM9QUyUj2kU9CA4eRey5wBx+BjbzHkSXXt6tOk9pDkeg56wuKR9L3g1BldcwBEacW2fU4pfEW9vpJC9QTCU/FAT0JXMTpYOaeIn+uf9eQRlRNguI1eUoWJAiGQgVQ/TlFlkdVqeE0pHp3Ntod2r+pkb4vCKrMDI6HW28XsM0uMupOfBUL8zRNFEOvLtswJduVo5r5Fd1ysHFcFywHOT0A==",
"timestamp":"2023-01-17 17:59:00",
"appKey":"123456",
"tradeLinks":"https://steamcommunity.com/tradeoffer/new/?partner=12345678912&token=LBPW679"
}
```

--------------------------------

### Query Order Status Failed Response Example

Source: https://www.yuque.com/yyyoupin/azx6iu/qfbnrlo6f947cw93

An example of a response from the orderStatus API indicating an order failure. It includes a status code, message, timestamp, data object with order details, and specific failCode and failReason for the failure.

```json
{
"code": 0,
"msg": "成功",
"timestamp": 1674008512095,
"data": {
"orderNumber": "2023011310000104278",
"statusMsg": "已取消-对方发送报价超时",
"bigStatus": 280,
"bigStatusMsg": "已取消",
"smallStatus": 1417,
"smallStatusMsg": "支付前取消",
"failCode": "5410",
"failReason": "拿交易链接获取steamId失败"
}
}
```

--------------------------------

### Java API Parameter Preparation and Signing

Source: https://www.yuque.com/yyyoupin/azx6iu/vshk4xof6c2lus77_language=zh-cn

This snippet demonstrates how to prepare parameters for an API request in Java. It involves creating a map of parameters, sorting them by key, and then concatenating them into a string for signing. It utilizes `java.util.Arrays`, `java.util.HashMap`, and a custom `StringUtils` and `JacksonUtils`.

```java
Map<String, Object> params = new HashMap<>();
params.put("timestamp","2022-12-02 15:31:00");
params.put("appKey","123456");
params.put("idempotentId","202211290105");
params.put("purchasingInfoList",list);
  

// 第一步：检查参数是否已经排序
String[] keys = params.keySet().toArray(new String[0]);
Arrays.sort(keys);
// 第二步：把所有参数名和参数值串在一起
StringBuilder stringBuilder = new StringBuilder();
for (String key : keys) {
Object value = params.get(key);
if (!StringUtils.isEmpty(value)) {
stringBuilder.append(key).append(JacksonUtils.writeValueAsString(value));
}
}
```

--------------------------------

### Modify Accessory Price Request Example (JSON)

Source: https://www.yuque.com/yyyoupin/azx6iu/vg6ui3tqx9wr6ar0_language=en-us

This is a JSON request example demonstrating how to structure the payload for modifying accessory prices. It includes essential parameters like appKey, timestamp, sign, steamId, and a list of commodity changes with their IDs and new prices. Ensure the timestamp is in GMT+8 and adheres to the allowed time error.

```json
{
  "appKey":"1000", 
  "timestamp":"2023-10-02 12:10:10"
  "sign":"xxxxxxxxxxx"
  "steamId":"10022333000", 
  "requestList":[
    {"commodityId":"2001", "price":"5.05"},
    {"commodityId":"2002", "price":"6.3"}
  ]
}
```

--------------------------------

### POST /open/v1/api/byTemplateAsyncCreateOrderV2

Source: https://www.yuque.com/yyyoupin/azx6iu/tto20cgq3gfaam02

This endpoint enables developers to rapidly create an order for a specified item template, prioritizing speed and cost-efficiency by locking the best available price asynchronously.

```APIDOC
## POST /open/v1/api/byTemplateAsyncCreateOrderV2

### Description
Allows developers to quickly purchase specified templates (only templates with no wear and tear) through this interface, placing orders faster than the synchronous interface by locking the lowest price items less than or equal to the purchase price within 5 seconds. It asynchronously verifies transaction links and payments, increasing order frequency and reducing purchase costs.

### Method
POST

### Endpoint
https://gw-openapi.youpin898.com/open/v1/api/byTemplateAsyncCreateOrderV2

### Parameters
#### Request Body
- **merchantOrderNo** (String) - Required - Merchant order number (numeric or alphanumeric string up to 59 characters).
- **tradeLinks** (String) - Required - Steam trade link of the recipient.
- **commodityTemplateId** (String) - Required - Commodity template ID. Either `commodityTemplateId` or `commodityHashName` must be provided. If both are provided, `commodityTemplateId` takes precedence. Cannot be 0.
- **commodityHashName** (String) - Required - Template hash name. Either `commodityTemplateId` or `commodityHashName` must be provided. If both are provided, `commodityTemplateId` takes precedence. Cannot be empty.
- **purchasePrice** (String) - Required - Maximum purchase price in Yuan. Cannot be 0.
- **fastShipping** (Integer) - Optional - Fast shipping purchase mode. 0: Prioritize fast shipping; 1: Only purchase fast shipping.

### Request Example
```json
{
  "merchantOrderNo": "123456789",
  "tradeLinks": "https://steamcommunity.com/tradeoffer/new/?partner=123456789&token=abcdefg",
  "commodityTemplateId": "TEMPLATEID123",
  "purchasePrice": "100.00",
  "fastShipping": 0
}
```

### Response
#### Success Response (200)
- **data** (Object) - Response message body.
  - **merchantOrderNo** (String) - Merchant order number.
  - **orderNo** (String) - Youpin order number.
  - **shippingMode** (Integer) - Shipping mode: 0, Seller direct shipping; 1, Fast shipping.
  - **commodityPrice** (BigDecimal) - Commodity price in Yuan.
  - **status** (String) - Order status: 120, Pending payment.

#### Response Example
```json
{
  "data": {
    "merchantOrderNo": "123456789",
    "orderNo": "YOP1234567890",
    "shippingMode": 0,
    "commodityPrice": "95.50",
    "status": "120"
  }
}
```

### Error Handling
- **Common Errors**:
  - `code: 4010, msg: Parameter error`
- **Specific Errors**:
  - `5201`: Trading function of this account is banned. Contact customer service.
  - `5202`: The recipient is temporarily restricted from purchasing due to multiple instances of not receiving or rejecting orders in the past 12 hours. This restriction will be lifted after %s.
  - `5212`: Insufficient balance. Ensure sufficient balance before creating an order.
  - `5213`: No items available within this price limit.
  - `5214`: No items on sale. Please select other items.
  - `5301`: Commodity status has changed, cannot purchase. Please select other items.
  - `5299`: Cannot purchase.
  - `5408`: Incorrect format for the recipient's trading link.
```

--------------------------------

### Java: Sign data using parameters

Source: https://www.yuque.com/yyyoupin/azx6iu/vshk4xof6c2lus77

This Java code snippet demonstrates how to prepare parameters for signing. It involves putting key-value pairs into a map, sorting the keys, and concatenating them with their values. This is a common first step in many API signing processes.

```Java
params.put("timestamp","2022-12-02 15:31:00");
params.put("appKey","123456");
params.put("idempotentId","202211290105");
params.put("purchasingInfoList",list);
  
// 第一步：检查参数是否已经排序
String[] keys = params.keySet().toArray(new String[0]);
Arrays.sort(keys);
// 第二步：把所有参数名和参数值串在一起
StringBuilder stringBuilder = new StringBuilder();
for (String key : keys) {
Object value = params.get(key);
if (!StringUtils.isEmpty(value)) {
stringBuilder.append(key).append(JacksonUtils.writeValueAsString(value));
}
}
```

--------------------------------

### Request Body for Seller Get Order By Trade Offer ID API

Source: https://www.yuque.com/yyyoupin/azx6iu/sag1i4fypa0h62tf_language=zh-cn

This JSON object represents the payload required for the Seller Get Order By Trade Offer ID API. It includes essential parameters such as the trade offer ID, application key, timestamp, and signature for authentication and request processing.

```json
{
  "tradeOfferId":"6456079693",
  "appKey":"12324324",
  "timestamp":"2023-10-13 17:38:35",
  "sign":"FHyCvC9Eb8nweAIhBzByqLWSj9q3c383OFz8yubveGvChn9CXrArqiGPGHpba9Uo1022222w4qXDHWuK7QYnDdIx6HQ=="
}
```

--------------------------------

### POST /open/v1/api/byGoodsIdCreateOrderV2

Source: https://www.yuque.com/yyyoupin/azx6iu/pqpqu742oxd6cv1d_language=en-us

Allows developers to purchase specified goods. This endpoint is specifically for purchasing items with no durability loss.

```APIDOC
## POST /open/v1/api/byGoodsIdCreateOrderV2

### Description
Allows developers to purchase specified goods (only supports purchasing items with no durability loss).

### Method
POST

### Endpoint
https://gw-openapi.youpin.com/open/v1/api/byGoodsIdCreateOrderV2

### Parameters
#### Request Body
- **merchantOrderNo** (String) - Required - Merchant order number (string up to 59 characters).
- **tradeLinks** (String) - Required - Steam trade link of the recipient.
- **commodityId** (String) - Required - Commodity ID (cannot be 0).
- **purchasePrice** (String) - Required - Maximum purchase price (unit: Yuan, cannot be 0).

### Request Example
```json
{
  "merchantOrderNo": "123456789",
  "tradeLinks": "https://steamcommunity.com/tradeoffers/new/?partner=123456789&token=abcdefg",
  "commodityId": "987654321",
  "purchasePrice": "10.00"
}
```

### Response
#### Success Response (200)
- **data** (Object) - Response message body.
  - **merchantOrderNo** (String) - Merchant order number.
  - **orderNo** (String) - Order number.
  - **payAmount** (number) - Actual payment amount.
  - **orderStatus** (Integer) - Transaction status: 0, success; 2, failure.

#### Response Example
```json
{
  "data": {
    "merchantOrderNo": "123456789",
    "orderNo": "ORDER987654321",
    "payAmount": 10.00,
    "orderStatus": 0
  }
}
```

### Error Codes
- **5201**: The account's trading function is banned. Please contact customer service.
- **5202**: The recipient has had multiple instances of not receiving or rejecting gifts in the past 12 hours, and the system has temporarily restricted their purchases. This restriction will be lifted after %s.
- **5212**: Insufficient balance. Please ensure your balance is sufficient before creating an order.
- **5213**: No goods available within this price limit.
- **5214**: No goods on sale currently. Please select other goods.
- **5301**: The commodity status has changed and cannot be purchased at this time. Please select other goods.
- **5302**: You cannot buy your own goods. Please select other goods.
- **5303**: This commodity is for private trading only. Please select other goods.
- **5304**: This commodity is for rent only, not for sale. Please select other goods.
- **5299**: Cannot purchase.
- **5401**: Steam network anomaly.
- **5402**: Please try again later.
- **5403**: The recipient's Steam account cannot trade at this time.
- **5404**: The recipient's Steam account is banned and cannot trade.
- **5405**: The recipient's trade link has expired.
- **5406**: The recipient's Steam inventory is not public and cannot be traded.
- **5407**: Cannot input your own trade link.
- **5408**: The recipient's trade link format is incorrect.
```

--------------------------------

### Successful Response for Seller Get Order By Trade Offer ID API

Source: https://www.yuque.com/yyyoupin/azx6iu/sag1i4fypa0h62tf_language=zh-cn

This JSON object illustrates a successful response from the Seller Get Order By Trade Offer ID API. It contains a status code (0 for success), a message, a timestamp, and a data field which is an array of Youpin order numbers associated with the queried trade offer ID.

```json
{
  "code": 0,
  "msg": "成功",
  "timestamp": 1697189916419,
  "data": [
    "6834651005920606"
  ]
}
```

--------------------------------

### POST /open/v1/api/byGoodsIdCreateOrderV2

Source: https://www.yuque.com/yyyoupin/azx6iu/pqpqu742oxd6cv1d_language=zh-cn

Creates an order to purchase a specified item. This endpoint is designed for buying items with no wear and tear.

```APIDOC
## POST /open/v1/api/byGoodsIdCreateOrderV2

### Description
Allows developers to purchase specified items (only supports items with no wear and tear) through this interface.

### Method
POST

### Endpoint
https://gw-openapi.youpin898.com/open/v1/api/byGoodsIdCreateOrderV2

### Parameters
#### Request Body
- **merchantOrderNo** (String) - Required - Merchant order number. A string of up to 59 characters.
- **tradeLinks** (String) - Required - Steam trade link of the recipient.
- **commodityId** (String) - Required - Commodity ID. Cannot be 0.
- **purchasePrice** (String) - Required - The highest purchase price. Unit: Yuan. Cannot be 0.

### Request Example
```json
{
  "merchantOrderNo": "your_merchant_order_id",
  "tradeLinks": "https://steamcommunity.com/tradeoffer/new/?partner=123456789&token=abcdefgh",
  "commodityId": "123456789",
  "purchasePrice": "10.50"
}
```

### Response
#### Success Response (200)
- **data** (Object) - Response message body.
  - **merchantOrderNo** (String) - Merchant order number.
  - **orderNo** (String) - Order number.
  - **payAmount** (number) - Actual payment amount.
  - **orderStatus** (Integer) - Transaction status: 0, success; 2, failure.

#### Response Example
```json
{
  "data": {
    "merchantOrderNo": "your_merchant_order_id",
    "orderNo": "yy_order_1234567890",
    "payAmount": 10.50,
    "orderStatus": 0
  }
}
```

### Error Codes
- **5201**: Trading function for this account is banned. Please contact customer service.
- **5202**: The proxy recipient has had multiple instances of not receiving or refusing orders in the past 12 hours; the system temporarily restricts them from purchasing. This restriction will be lifted after %s.
- **5212**: Insufficient balance. Please ensure sufficient balance before creating an order.
- **5213**: No goods available for purchase within this price limit.
- **5214**: No goods currently for sale. Please choose other goods.
- **5301**: Item status has changed and cannot be purchased at this time. Please choose other goods.
- **5302**: You cannot purchase your own items. Please choose other goods.
- **5303**: This is a private trading item. Please choose other goods.
- **5304**: This item is for rent only, not for sale. Please choose other goods.
- **5299**: Cannot purchase.
- **5401**: Steam network anomaly.
- **5402**: Please try again later.
- **5403**: Proxy recipient's Steam account cannot trade at this time.
- **5404**: Proxy recipient's Steam account is banned and cannot trade.
- **5405**: Proxy recipient's trade link has expired.
- **5406**: Proxy recipient's Steam inventory is not public and cannot trade.
- **5407**: Cannot enter your own trade link.
- **5408**: Proxy recipient's trade link format is incorrect.
```

--------------------------------

### YY Youpin Open Platform API

Source: https://www.yuque.com/yyyoupin/azx6iu/mw73n89f80gdnsrn

This section details the request parameters, examples, and response structures for the YY Youpin Open Platform.

```APIDOC
## YY Youpin Open Platform API

### Description
Provides documentation for the YY Youpin Open Platform, including request parameters and response details.

### Method
GET

### Endpoint
/websites/yuque_yyyoupin_azx6iu

### Parameters
#### Query Parameters
- **None specified**

#### Request Body
- **None specified**

### Request Example
```json
{
  "example": "No request body example available."
}
```

### Response
#### Success Response (200)
- **Structure**: Details on the response structure are not explicitly provided in the input text, but it is expected to contain information related to the platform.

#### Response Example
```json
{
  "example": "Response structure not specified."
}
```
```

--------------------------------

### Order Status Codes

Source: https://www.yuque.com/yyyoupin/azx6iu/index

A reference guide to the various order status codes used within the 悠悠有品 open platform to indicate the current state of an order.

```APIDOC
## Order Status Codes

### Description
This document lists and explains the different status codes associated with orders placed through the 悠悠有品 open platform.

### Method
Not Applicable (General Information)

### Endpoint
Not Applicable (General Information)

### Parameters
Not Applicable (General Information)

### Request Example
Not Applicable (General Information)

### Response
Not Applicable (General Information)

### Status Codes
- **10**: Pending Payment
- **20**: Paid
- **30**: Shipped
- **40**: Received
- **50**: Completed
- **60**: Cancelled
- **70**: Refunded
```

--------------------------------

### Java RSA Signing Implementation

Source: https://www.yuque.com/yyyoupin/azx6iu/vshk4xof6c2lus77

Demonstrates how to sign data using a private RSA key in Java. It includes a nested `PurchasingInfo` class for structuring data and a `main` method that sets up sample data, creates a map of parameters, and would typically proceed to generate a signature. The code snippet is a starting point for the signing process.

```Java
import java.math.BigDecimal;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class RSASigner {

    @Data
    static class PurchasingInfo {
        private Integer commodityId;
        private BigDecimal commodityPrice;
        private String tradeLinks;
    }

    /**
     * 采用私钥签名
     * @param args
     * @throws Exception
     */
    public static void main(String[] args) throws Exception {
        String pvtKey = "私钥"; // Placeholder for actual private key

        PurchasingInfo purchasingInfo = new PurchasingInfo();
        purchasingInfo.setCommodityId(422542);
        purchasingInfo.setCommodityPrice(BigDecimal.valueOf(50));
        purchasingInfo.setTradeLinks("https://steamcommunity.com/tradeoffer/new/?partner=12345678912&token=LBPW679");
        List<PurchasingInfo> list = new ArrayList<>();
        list.add(purchasingInfo);
        Map<String, Object> params = new HashMap<>();
        // ... further steps to construct and sign the data would follow here
    }
}
```
Tokens:
Raw