查询充值商品 – 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	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。
serverId	int	一级服务器ID。
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"。

iii. 报错示例

响应报错

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

常见报错代码

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