查詢商城商品列表

查詢積分商城商品列表，支持分頁、排序及類型過濾。

HTTP 請求

POST/v5/card/reward/mall/item/list

請求參數

參數	是否必需	類型	說明
pageNo	false	integer	頁碼，默認 1，最小值 1
pageSize	false	integer	每頁條數，默認 10，最小值 1
itemType	false	integer	商品類型。1: 虛擬商品，2: 實體商品
itemBizType	false	integer	商品子類型。1: POINTS，2: CURRENCY
orderBy	false	integer	排序類型。1: 優先級，2: 上架時間，3: 價格
asc	false	boolean	是否升序排列
source	false	integer	查詢來源。0: 默認，1: VIP 商品列表

響應參數

參數	類型	說明
retCode	integer	業務返回碼。0: 成功；非零: 失敗
retMsg	string	返回消息
result	object
> pageNo	integer	當前頁碼
> pageSize	integer	每頁條數
> totalCount	integer	總記錄數
> data	array	商品列表
>> itemId	string	商品 ID
>> itemName	string	商品名稱
>> priority	integer	優先級
>> onTime	string	上架時間（Unix 毫秒時間戳）
>> offTime	string	下架時間（Unix 毫秒時間戳）
>> price	string	價格
>> discountPrice	string	折扣價
>> totalNum	integer	總數量
>> redeemNum	integer	已兌換數量
>> picPath	string	圖片路徑
>> currency	string	幣種。USDT、USDC、BTC、ETH、POINT
>> currencyType	integer	幣種類型。FIAT、CRYPTO、POINT
>> itemType	integer	商品類型。VIRTUAL、ENTITY
>> itemBizType	integer	商品子類型。POINTS、CURRENCY

---

請求示例

HTTP

POST /v5/card/reward/mall/item/list?pageNo=1&pageSize=10 HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1672211918471
X-BAPI-RECV-WINDOW: 5000

Python

import requests

url = "https://api-testnet.bybit.com/v5/card/reward/mall/item/list"
headers = {
    "X-BAPI-API-KEY": "xxxxxxxxxxxxxxxxxx",
    "X-BAPI-SIGN": "XXXXX",
    "X-BAPI-TIMESTAMP": "1672211918471",
    "X-BAPI-RECV-WINDOW": "5000"
}
params = {
    "pageNo": 1,
    "pageSize": 10
}
response = requests.post(url, headers=headers, params=params)
print(response.json())

Node.js

const axios = require('axios');

const url = 'https://api-testnet.bybit.com/v5/card/reward/mall/item/list';
const headers = {
  'X-BAPI-API-KEY': 'xxxxxxxxxxxxxxxxxx',
  'X-BAPI-SIGN': 'XXXXX',
  'X-BAPI-TIMESTAMP': '1672211918471',
  'X-BAPI-RECV-WINDOW': '5000'
};
const params = { pageNo: 1, pageSize: 10 };

axios.post(url, {}, { headers, params })
  .then(response => console.log(response.data))
  .catch(error => console.error(error));

響應示例

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "pageNo": 1,
        "pageSize": 10,
        "totalCount": 5,
        "data": [
            {
                "itemId": "ITEM001",
                "itemName": "Amazon Gift Card $10",
                "priority": 1,
                "onTime": "1672211918471",
                "offTime": "1704000000000",
                "price": "5000",
                "discountPrice": "4500",
                "totalNum": 1000,
                "redeemNum": 200,
                "picPath": "/images/item001.png",
                "currency": "POINT",
                "currencyType": 3,
                "itemType": 1,
                "itemBizType": 1
            }
        ]
    },
    "retExtInfo": {},
    "time": 1672211918471
}