查询充值分类 – PlayerAuctions 帮助中心

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

查询特定游戏的充值分类。

i. 请求参数

路径参数

参数	类型	必填	描述
id	int	Yes	Game ID.

ii. 响应示例

成功响应

{
  "code": 10000,
  "message": "Operation Successful.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": [
    {
      "categoryId": 105,
      "categoryName": "Category- B",
      "deliveryType": 2,
      "deliveryTypeName": "Manual Top-Up",
      "quantityType": 1,
      "quantities": [
        {
            "id": 1515,
            "fixQuantity": 1,
            "bonusQuantity": 0
        },
        {
            "id": 1516,
            "fixQuantity": 5,
            "bonusQuantity": 2
        },
        {
            "id": 1517,
            "fixQuantity": 10,
            "bonusQuantity": 5
        }
      ]
    },
    {
      "categoryId": 104,
      "categoryName": "Category-A",
      "deliveryType": 1,
      "deliveryTypeName": "UID",
      "quantityType": 1,
      "quantities": [
        {
          "id": 1513,
          "fixQuantity": 50,
          "bonusQuantity": 10
        },
        {
          "id": 1514,
          "fixQuantity": 100,
          "bonusQuantity": 100
        }
      ]
    }
  ]
}

响应参数

参数	类型	描述
code	int	报错代码。常见值: 10002 (无效参数), 50001 (服务器内部错误)。
message	string	报错详情。
requestId	string	请求标识号，用以追溯。
data	array	该游戏的充值分类列表。
data[].categoryId	int	分类 ID。
data[].categoryName	string	分类名称。
data[].deliveryType	int	发货类型代码。1 = UID直充，2 = 手工代充。
data[].deliveryTypeName	string	发货类型名称。
data[].quantityType	int	数量规格类型。1 = 固定面额/数量，2 = 自定义面额/数量（弹性）。
data[].quantities	array	该分类下可用的数量/面额选项列表。
data[].quantities[].id	int	数量/面额选项的唯一标识符（选项 ID）。
data[].quantities[].fixQuantity	int	基础数量/基础面额。
data[].quantities[].bonusQuantity	int	该选项包含的赠送数量/附赠面额（如：充 648 赠送 90 里的“90”）。

iii. 报错示例

响应报错

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

常见报错代码

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