查询道具商品 – PlayerAuctions 帮助中心

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

通过报价单ID查询单个道具商品。

i. 请求参数

路径参数

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

ii. 响应示例

成功响应


{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data":
  {
    "minUnitPerOrder": 1.000,
    "totalUnit": 2000,
    "instruction": "this is an instruction.",
    "deliveryGuarantee": 4,
    "discounts": [
      {
        "startPrice": 10.00,
        "discountRate": 1.00000
      },
      {
        "startPrice": 50.00,
        "discountRate": 2.00000
      },
      {
        "startPrice": 100.00,
        "discountRate": 5.00000
      }
    ],
    "categoryId": 3638,
    "serverId": 3638,
    "itemId": 1243,
    "itemPath": "290|1243",
    "screenShot": "https://cdn-image.azureedge.net/title-image/liutest6/202606090117171717.png",
    "itemsPerUnit": 10.000,
    "otherItem": "",
    "rootItem": 290,
    "blobName": "202606090117171717.png",
    "gameId": 3637,
    "price": 5.0000,
    "offerDuration": 30,
    "title": "Offer Title",
    "offerDesc": "<p>Offer Description</p>",
    "offerId": 71394134,
    "memberId": 678694,
    "state": 1,
    "productType": "item"
  }
}

响应参数

参数	类型	描述
code	int	响应状态码。 10000表示成功，其他值表示发生错误。
message	string	响应消息。该字段包含具体的错误详情。
requestId	string	请求标识号，用以追溯。
data	object	道具商品详情。
data.minUnitPerOrder	decimal	单笔订单最小购买份数。
data.totalUnit	int	总份数。
data.instruction	string	发货说明。
data.deliveryGuarantee	int	发货期限。通过customId设置赋值。选项列表可通过（api/v1/games/{id}/{type}/deliveryTimes）接口获取。
data.discounts	array	折扣规则。
data.discounts[].startPrice	decimal	折扣起始价格。
data.discounts[].discountRate	decimal	折扣率。
data.categoryId	int	二级服务器ID。
data.serverId	int	一级服务器ID。
data.itemId	int	二级道具ID。
data.itemPath	string	商品路径。格式: rootItemId\|itemId。
data.screenShot	string	商品图片链接。
data.itemsPerUnit	decimal	每份道具数量。
data.otherItem	string	自定义道具名称。
data.rootItem	int	一级道具ID。
data.blobName	string	图片显示名称。
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	请求标识号，用以追溯。