查询货币商品 – PlayerAuctions 帮助中心

GEThttps://seller-api.playerauctions.com/api/v1/offers/currency/{id}

根据报价单ID查询单个货币商品。

i. 请求参数

路径参数

参数	类型	必填	描述
id	int	是	报价单ID。

ii. 响应示例

成功响应

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "minUnitPerOrder": 1.000,
    "totalUnit": 100,
    "currencyPerUnit": 100.000,
    "instruction": "simple instruction",
    "deliveryGuarantee": 5,
    "discounts": [
        {
            "startPrice": 10.00,
            "discountRate": 2.00000
        },
        {
            "startPrice": 20.00,
            "discountRate": 4.00000
        },
        {
            "startPrice": 50.00,
            "discountRate": 8.00000
        }
    ],
    "categoryId": 6590,
    "currencyTypeId": 0,
    "serverId": 6590,
    "gameId": 3637,
    "price": 5.0000,
    "offerDuration": 30,
    "title": "Simple Title",
    "offerDesc": "<p>Simple Description</p",
    "offerId": 71394132,
    "memberId": 678694,
    "state": 1,
    "productType": "currency"
  }
}

响应参数

参数	类型	描述
code	int	响应状态码。 10000表示成功，其他值表示发生错误。
message	string	响应消息。该字段包含具体的错误详情。
requestId	string	请求标识号，用以追溯。
data	object	货币商品详情。
data.minUnitPerOrder	decimal	单笔订单最小购买份数。
data.totalUnit	int	总份数。
data.currencyPerUnit	decimal	每份货币数量。
data.instruction	string	发货说明。
data.deliveryGuarantee	int	发货期限。通过customId设置赋值。选项列表可通过（api/v1/games/{id}/{type}/deliveryTimes）接口获取。
data.discounts	array	折扣规则。
data.discounts[0].startPrice	decimal	折扣起始价格。
data.discounts[0].discountRate	decimal	折扣比例。
data.categoryId	int	叶子节点 ID。服务器树形结构数据可通过（api/v1/games/{id}/{type}/servers）接口获取。
data.currencyTypeId	int	货币类型 ID。
data.serverId	int	服务器 ID。
data.gameId	int	游戏 ID。
data.price	decimal	每份货币价格.
data.offerDuration	int	商品有效期天数。可选值：3, 7, 14, 或30。
data.title	string	商品标题。
data.offerDesc	string	商品描述。
data.offerId	int	商品报价单ID.
data.memberId	int	该报价单的卖家/会员 ID
data.state	int	该报价单的状态。
data.productType	string	商品类型。

iii. 报错示例

响应报错

{
  "code": 10002,
  "message": "Offer not found.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

常见报错代码

参数	类型	描述
code	int	报错代码。常见值: 10002 (无效参数), 50001 (服务器内部错误)。
message	string	报错详情。
requestId	string	请求标识号，用以追溯。