查询充值商品 – PlayerAuctions 帮助中心

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

通过商品ID查询单个充值商品。

i. 请求参数

路径参数

参数	类型	必填	描述
id	int	是	Offer ID.

ii. 响应示例

成功响应

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "minUnitPerOrder": 10.000,
    "totalUnit": 2000,
    "currencyPerUnit": 10.000,
    "instruction": "Simple Instruction.",
    "deliveryGuarantee": 6,
    "discounts": [],
    "categoryId": 3638,
    "serverId": 3638,
    "deliveryTime": 0,
    "topUpCategoryId": 102,
    "deliveryType": 1,
    "deliveryTypeName": "UID",
    "gameId": 3637,
    "price": 5.0000,
    "offerDuration": 30,
    "title": "Simple Title",
    "offerDesc": "<p>Simple Description.</p>",
    "offerId": 71394388,
    "memberId": 678694,
    "state": 1,
    "productType": "topup"
  }
}

响应报错

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

iii. 响应参数

参数	类型	描述
code	int	响应状态码。 10000表示成功，其他值表示发生错误。
message	string	响应消息。该字段包含具体的错误详情。
requestId	string	请求标识号，用以追溯。
data	object	充值商品详情。
└─ minUnitPerOrder	decimal	单笔订单最小购买份数。
└─ totalUnit	int	总份数。
└─ currencyPerUnit	decimal	每份货币数量。
└─ instruction	string	发货说明。
└─ deliveryGuarantee	int	发货期限。通过customId设置赋值。选项列表可通过（api/v1/games/{id}/{type}/deliveryTimes）接口获取。
└─ discounts	array	折扣规则。
└─ categoryId	int	阵营ID（子节点 {id})。树状结构可通过（api/v1/games/{id}/{type}/servers）接口获取。
└─ serverId	int	服务器ID {id}。树状结构可通过（api/v1/games/{id}/{type}/servers）接口获取。
└─ deliveryTime	int	发货期限。
└─ topUpCategoryId	int	T充值类别ID。
└─ deliveryType	int	发货方式。1 (UID), 2 (Manual Top-Up).
└─ deliveryTypeName	string	发货方式名称 (例如 "UID", "Manual Top-Up")。
└─ gameId	int	游戏ID。
└─ price	decimal	每份充值商品单价。
└─ offerDuration	int	商品有效期天数。可选值：3, 7, 14, 或30。
└─ title	string	商品标题。
└─ offerDesc	string	商品描述。
└─ offerId	int	商品ID.
└─ memberId	int	该商品的卖家/会员 ID。
└─ state	int	该商品的状态。
└─ productType	string	商品类型。充值累商品为 "topup"。