Overview

歡迎使用 IPFast 文檔， IPFast 是一個專業的基礎網路與雲計算平臺。

基礎網路

基礎網路為您提供高質量的住宅代理和靜態住宅代理服務, 主要包含以下兩大核心產品：

住宅代理（Residential Proxy）

住宅代理服務提供來自真實住宅 IP 的代理，具有以下特點：

• 全球覆蓋：支援全球多個國家和地區的 IP
• 動態切換：支援自動切換 IP，避免被封禁
• 高度定製：可根據國家、州/省、城市進行精確定位
• 通道管理：支援創建多個獨立通道，便於業務隔離
• 實時監控：提供詳細的流量統計和使用報告

數據中心代理（Datacenter Proxy）

數據中心服務提供來自數據中心集群的代理，具有以下特點：

• 全球覆蓋：支援全球多個國家和地區的 IP
• 動態切換：支援自動切換 IP，避免被封禁
• 高度定製：可根據國家、州/省、城市進行精確定位
• 通道管理：支援創建多個獨立通道，便於業務隔離
• 實時監控：提供詳細的流量統計和使用報告

靜態住宅代理（Static Residential Proxy）

靜態住宅代理提供固定的住宅 IP 地址，特別適合需要穩定 IP 的場景：

• 固定 IP：提供長期穩定的固定 IP 地址
• 高可用性：保證 IP 地址的長期可用性
• 商戶管理：支援商戶白名單功能
• 靈活訂閱：支援按需訂閱和續費
• IP 更換：支援在需要時更換 IP 地址

雲計算

雲計算也包含以下兩大核心產品：

輕量伺服器（Container VPS)

輕量伺服器業務特性除了具有靜態住宅IP的特性外，還允許用戶安裝少量輕量級的軟體，具有以下特點：

• 靜態 IP：類似於靜態住宅IP的網路特性表現
• 支援登入：支援用戶SSH登入伺服器後臺
• 軟體安裝：允許用戶安裝少量輕量級的軟體
• 資源隔離：硬體資源隔離，便於業務隔離
• 實時監控：提供詳細的流量統計和使用報告

獨享伺服器（待上線)

獨享伺服器業務特性除了具有輕量伺服器的特性外，實現了所有的硬體資源獨享，具有以下特點：

• 靜態 IP：類似於靜態住宅IP的網路特性表現
• 支援登入：支援用戶SSH登入伺服器後臺
• Windows：支援Windows操作系統
• 資源隔離：硬體資源全隔離，便於業務高負載使用
• 實時監控：提供詳細的流量統計和使用報告

快速開始

1. 瞭解認證方式 - 獲取並使用 API Key
2. 選擇適合您的代理類型：
   • 住宅代理服務
   • 靜態代理服務

技術支援

如果您在使用過程中遇到任何問題，或需要了解更多資訊，請通過以下方式聯絡我們：

• 在線客服：通過網站聊天窗口
• 技術文檔：本站點提供詳細的 API 文檔和使用指南

我們致力於為您提供最優質的代理服務和技術支援。

認證方式

IPFast API 使用 API Key 進行認證。每個請求都需要在 HTTP Header 中包含您的 API Key。

API Key 認證

在每個 API 請求的 Header 中添加CODE和TOKEN字段：

--header 'x-merchant-token: CODE'
--header 'x-merchant-code: TOKEN'

示例：

fetch('/api/ipft/simple/check', {
  headers: {
    'x-merchant-token': 'YOU TOKEN',
    'x-merchant-code': 'YOU CODE'
  }
})

示例輸出：

{"msg":"驗證成功，歡迎使用","code":200}

獲取 API Key

1. 登入您的 IPFast 帳戶
2. 進入控制面板的 API 設置頁面
3. 生成新的 API Key

安全建議

• 請妥善保管您的 API Key，不要洩露給他人
• 定期更換 API Key 以提高安全性
• 不要在客戶端代碼中硬編碼 API Key
• 如果懷疑 API Key 洩露，請立即重新生成

動態 IP

動態 IP 核心介面說明。

開放介面與文檔

與控制檯請求一致的 URL、請求頭（x-merchant-token、x-merchant-code）即可通過開放 API 調用。訂單創建、列表與支付見 訂單服務。

服務目錄

套餐與下單

• 獲取流量套餐列表
  • 查詢可購買的動態流量套餐
  • 支援按容量/標題篩選
• 獲取套餐詳情
  • 查詢總流量、剩餘流量、到期時間
• 下單流量套餐
  • 生成動態流量訂單
  • 返回訂單號用於後續支付
• 流量分配訂單
  • 查詢流量分配訂單

子帳號管理

• 獲取子帳號列表
  • 查詢子帳號基礎資訊
• 查詢子帳號流量餘額
  • 按子帳號查詢剩餘/總量/已用流量（MB）
• 創建子帳號
  • 創建動態子帳號
• 編輯子帳號（流量）
  • 調整子帳號分配流量
• 刪除子帳號（回收）
  • 回收子帳號並退回套餐可分配流量

地區與導出

• 獲取可用地區
  • 按帳號獲取國家/州/城市樹
  • 按帳號來源返回可用地區數據
• 導出代理串
  • 批量生成可用代理串

訂單服務

• 訂單服務
  • 訂單列表
  • 訂單支付

獲取流量套餐列表

查詢動態流量套餐，用於下單頁展示可選套餐。

介面資訊

GET /client/ip/dynamics/planConfig

請求頭

請求參數

請求示例

const response = await fetch('/client/ip/dynamics/planConfig?pageNum=1&pageSize=10', {
  method: 'GET',
  headers: {
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  }
})

const result = await response.json()

回應示例

{
  "total": 2,
  "rows": [
    {
      "id": 101,
      "title": "Dynamic 50GB",
      "capacity": 50,
      "price": 399,
      "discount": 1,
      "days": 30,
      "status": "Y"
    }
  ],
  "code": 200,
  "msg": "查詢成功"
}

回應參數說明

注意事項

1. 介面僅返回可用套餐。
2. 返回體不包含 tenantId、merchantId、tenantPrice、createTime、updateTime。
3. 常用字段為 id/title/capacity/price/discount/days/status。

獲取套餐詳情

查詢當前帳號的動態流量套餐詳情，用於展示總流量、剩餘流量、到期時間等資訊。

介面資訊

GET /client/plan/detail

請求頭

請求參數

無

請求示例

const response = await fetch('/client/plan/detail', {
  method: 'GET',
  headers: {
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  }
})

const result = await response.json()

回應示例

{
  "code": 200,
  "msg": "操作成功",
  "data": {
    "id": 1001,
    "merchantId": 20001,
    "planType": "residential",
    "planTrafficGb": 50,
    "planResidueTrafficGb": 30,
    "expirationDate": "2026-12-31 00:00:00",
    "expired": 0,
    "createTime": "2026-01-01 10:00:00",
    "updateTime": "2026-04-01 12:00:00"
  }
}

回應參數說明

下單流量套餐

創建動態流量訂單，返回訂單號用於後續支付。

介面資訊

POST /client/order/addDynamics

請求頭

請求參數

請求示例

const response = await fetch('/client/order/addDynamics', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  },
  body: JSON.stringify({
    configPlanId: 101
  })
})

const result = await response.json()

回應示例

{
  "msg": "下單成功",
  "code": 200,
  "data": "N2026040100012345678"
}

回應參數說明

注意事項

1. 本介面只創建待支付訂單並返回訂單號，不涉及支付方式；支付時在 訂單支付 中指定方式（例如餘額支付可傳 BALANCE）。
2. 訂單數量固定為 1，流量容量以套餐設定為準。
3. 後端會校驗套餐是否可用，並按套餐價格計算訂單金額。
4. 下單後需要調用支付介面完成支付。

查詢流量分配訂單

查詢當前商戶分配流量記錄。用於核對套餐/流量曾向哪些子帳號做過分配及分配量、時間。

介面資訊

GET /client/plan/order/allocations

請求頭

請求參數

列表按 create_time 倒序（最新在前）。

回應示例

{
  "total": 2,
  "rows": [
    {
      "account_id": "384940",
      "plan_traffic_gb": 100.00,
      "create_time": "2025-07-22 11:19:40"
    },
    {
      "account_id": "384941",
      "plan_traffic_gb": 50.5,
      "create_time": "2025-07-21 09:00:00"
    }
  ],
  "code": 200,
  "msg": "查詢成功"
}

回應參數說明

代碼示例

fetch('/client/plan/order/allocations?pageNum=1&pageSize=20', {
  method: 'GET',
  headers: {
    'x-merchant-token': 'your_token',
    'x-merchant-code': 'your_code'
  }
})
  .then((r) => r.json())
  .then((data) => console.log(data));

創建子帳號

創建動態子帳號。

介面資訊

POST /client/dynamics/account

請求頭

請求參數

請求示例

const response = await fetch('/client/dynamics/account', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  },
  body: JSON.stringify({
    label: '業務A帳號',
    account: 'demo_sub_user_01',
    password: 'demo_pass_01',
    trafficLimit: 2
  })
})

const result = await response.json()

回應示例

{
  "msg": "操作成功",
  "code": 200
}

回應參數說明

注意事項

1. trafficLimit 僅支援正整數（如 1、2、3）。
2. 創建前需確保帳號有可用流量套餐。

獲取子帳號列表

查詢動態子帳號列表。

介面資訊

GET /client/dynamics/account/list

請求頭

請求參數

回應示例

{
  "total": 1,
  "rows": [
    {
      "accountId": "384940",
      "account": "account1234",
      "status": "active",
      "poolType": "standard",
      "trafficLimit": 1000,
      "remarks": null,
      "createTime": "2025-07-22 11:19:40"
    }
  ],
  "code": 200,
  "msg": "查詢成功"
}

回應參數說明

查詢子帳號流量餘額

查詢指定子帳號的動態 IP 流量餘額（剩餘、總量、已用等）。

介面資訊

GET /client/dynamics/account/balance/info

請求頭

請求參數

回應示例

{
    "total": 1,
    "rows": [
        {
          "accountId": "816219",
          "balance": 326999.978943,
          "balanceFormat": "326999.98 MB",
          "balanceTotal": 327000.000000,
          "balanceTotalFormat": "327000.00 MB",
          "balanceUsed": 0.021057,
          "balanceUsedFormat": "0.02 MB"
        }
    ],
    "code": 200,
    "msg": "查詢成功"
}

代碼示例

// 單個子帳號餘額
fetch('/client/dynamics/account/balance/info?accountId=816219', {
    method: 'GET',
    headers: {
        'x-merchant-token': 'your_token',
        'x-merchant-code': 'your_code'
    }
})
.then(response => response.json())
.then(data => console.log(data));

// 當前商戶全部子帳號餘額（分頁）
fetch('/client/dynamics/account/balance/info?pageNum=1&pageSize=10', {
    method: 'GET',
    headers: {
        'x-merchant-token': 'your_token',
        'x-merchant-code': 'your_code'
    }
})
.then(response => response.json())
.then(data => console.log(data));

回應參數說明

查詢接入點

查詢帳號可用的接入點列表。

介面資訊

GET /client/dynamics/account/endpoint/info

請求頭

請求參數

代碼示例

fetch('/client/dynamics/account/endpoint/info?accountId=1', {
    method: 'GET',
    headers: {
        'x-merchant-token': 'your_token',
        'x-merchant-code': 'your_code'
    }
})
.then(response => response.json())
.then(data => console.log(data));

回應示例

{
    "total": 1,
    "rows": [
        {
          "accountId": "384933",
          "endpointHost": "gate-us.host.io",
          "endpointPort": 13233,
          "supportedProtocol": "http"
        }
    ],
    "code": 200,
    "msg": "查詢成功"
}

回應參數說明

編輯子帳號（流量）

編輯動態子帳號資訊，重點用於調整分配流量，支援按 GB 調整總流量。

介面資訊

PUT /client/dynamics/account

請求頭

請求參數

請求示例

const response = await fetch('/client/dynamics/account', {
  method: 'PUT',
  headers: {
    'Content-Type': 'application/json',
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  },
  body: JSON.stringify({
    accountId: "y3i8cknw",
    trafficLimit: 8
  })
})

const result = await response.json()

回應示例

{
  "msg": "操作成功",
  "code": 200
}

回應參數說明

注意事項

1. trafficLimit 僅支援正整數（如 1、2、3）。

刪除子帳號（回收）

回收（刪除）當前商戶下的動態子帳號：解除佔用並按規則退回未使用流量至套餐可分配額度。

介面資訊

DELETE /client/dynamics/account/{accountIds}

請求頭

路徑參數

請求示例

const accountId = 'y3i8cknw'
const response = await fetch('/client/dynamics/account/' + encodeURIComponent(accountId), {
  method: 'DELETE',
  headers: {
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  }
})

const result = await response.json()

回應示例

{
  "msg": "操作成功",
  "code": 200
}

回應參數說明

獲取可用地區

根據動態子帳號查詢可用地區樹。

介面資訊

GET /client/dynamics/region/countries

請求頭

請求參數

請求示例

const response = await fetch('/client/dynamics/region/countries?accountId=123', {
  method: 'GET',
  headers: {
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  }
})

const result = await response.json()

回應示例

{
  "msg": "操作成功",
  "code": 200,
  "data": [
    {
      "countryCode": "US",
      "countryName": "United States",
      "states": [
        {
          "stateCode": "CA",
          "stateName": "California",
          "cities": [
            {
              "cityCode": "LosAngeles",
              "cityName": "Los Angeles"
            }
          ]
        }
      ]
    }
  ]
}

回應參數說明

注意事項

1. 介面返回國家/州/城市樹，前端可按需展開為三級下拉。

導出代理串

導出介面用於批量生成代理串。

介面資訊

POST /client/ip/dynamics/exportIp

請求頭

請求參數

請求示例

const response = await fetch('/client/ip/dynamics/exportIp', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  },
  body: JSON.stringify({
    accountId: '816222',
    endpointHost: 'as.example.net',
    endpointPort: '2333',
    count: 3,
    formatType: 3
  })
})

const result = await response.json()

回應示例

{
  "msg": "操作成功",
  "code": 200,
  "data": [
    "host:port:username:password"
  ]
}

回應參數說明

靜態代理

靜態代理服務提供固定IP地址的代理解決方案，支援多國家地區的IP資源，具有高穩定性和獨享性特點。

服務目錄

IP管理

• IP列表查詢
  • 查詢已購買的IP列表
  • 支援分頁和條件篩選
  • 顯示IP詳細資訊
• 修改帳密
  • 修改已購 IP 的帳號或密碼
• IP位置查詢
  • 查詢IP地理位置資訊
  • 實時狀態監控
  • 性能指標展示

訂單管理

• 訂單列表
  • 訂單狀態跟蹤
  • 訂單詳情查看
• 下單
  • 支援批量購買
  • 多種支付方式
  • 靈活的設定選項
• 訂單支付
  • 支援多種支付方式
  • 實時支付狀態更新
  • 支付結果通知

主要特點

• 固定的IP地址資源
• 穩定可靠的網路質量
• 多區域IP資源支援
• 完善的訂單管理系統
• 便捷的支付流程
• 詳細的使用文檔

快速開始

1. 查看IP資源

   • 使用IP位置查詢功能瀏覽可用資源
   • 選擇合適的IP地址

2. 購買服務

   • 通過下單功能選擇所需IP
   • 確認訂單資訊
   • 完成支付流程

3. 管理IP

   • 使用IP列表查詢功能管理已購IP
   • 監控IP使用狀態
   • 及時續費或升級服務

ip列表查詢

查詢已購買的靜態IP列表。

介面資訊

GET /client/ip/pool/item/merchantIpList

請求頭

請求參數

代碼示例

/client/ip/pool/item/merchantIpList?ip=156.252&status=1&type=1&pageSize=1

回應示例

{
  "total": 58,
  "rows": [
    {
      "createBy": null,
      "createTime": "2025-03-24 20:22:31",
      "updateBy": null,
      "updateTime": "2025-03-24 23:26:14",
      "remark": null,
      "id": 147,
      "poolId": 1,
      "merchantId": 1,
      "lastOrderId": 176,
      "sourceCode": null,
      "sourceName": null,
      "account": "justinka",
      "password": "34372766",
      "port": "2340",
      "ip": "156.252.8.76",
      "protocolse": null,
      "effectiveDatetime": "2025-03-24 20:22:31",
      "expireDatetime": "2025-05-23 20:22:31",
      "status": 1,
      "type": 1,
      "ipCategory": "HOST",
      "continent": "Asia",
      "countryCode": "VN",
      "location": "",
      "bandwidth": 10,
      "hot": "N"
    }
  ],
  "code": 200,
  "msg": "查詢成功"
}

回應參數說明

修改帳密

修改已購買靜態 IP 的帳號或密碼，支援批量（單次最多 10 個）。

介面資訊

POST /client/ip/pool/item/changeCredential

請求頭

請求參數

帳號、密碼至少填寫一項。

填寫時須滿足：首位為字母（不能為數字），長度 8-12 位，且同時包含大寫字母、小寫字母與數字。

請求示例

const response = await fetch('/client/ip/pool/item/changeCredential', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  },
  body: JSON.stringify({
    ipList: ['156.252.8.76', '156.252.8.77'],
    account: 'newuser',
    password: 'newpass123'
  })
});

const result = await response.json();

回應示例

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "successCount": 2,
    "failCount": 0,
    "successIPList": ["156.252.8.76", "156.252.8.77"],
    "failIPList": []
  }
}

回應字段

說明

• 僅支援狀態為「已生效」的 IP
• 單次最多 10 個 IP
• 部分 IP 可能不支援修改帳號或密碼，以介面返回為準

可購地區列表查詢

查詢可購買地區IP數量

介面資訊

GET /client/ip/pool/regionalAvailableIps

請求頭

請求參數

代碼示例

/client/ip/pool/regionalAvailableIps

回應示例

{
  "total": 3,
  "rows": [
    {
      "id": 19,
      "type": 1,
      "ipCategory": "HOST",
      "continent": "asia",
      "countryCode": "hk",
      "location": "hongkong",
      "bandwidth": 10,
      "price": 30.0000,
      "ipTotals": 100
    },
    {
      "id": 19,
      "type": 1,
      "ipCategory": "HOST",
      "continent": "asia",
      "countryCode": "hk",
      "location": "hongkong",
      "bandwidth": 5,
      "price": 20.0000,
      "ipTotals": 413
    },
    {
      "id": 24,
      "type": 1,
      "ipCategory": "HOST",
      "continent": "north_america",
      "countryCode": "us",
      "location": "newyork",
      "bandwidth": 5,
      "price": 18.0000,
      "ipTotals": 200
    }
  ],
  "code": 200,
  "msg": "查詢成功"
}

同一地區 id 可能出現多條記錄，以 bandwidth 區分不同帶寬規格；price、ipTotals 均為該帶寬規格下的單價與可購數量。

回應參數說明

錢包餘額查詢

錢包餘額查詢

介面資訊

GET /client/merchant/walletInfo

請求頭

回應示例

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "balance": 20.000,
    "totalAmount": 100.500
  }
}

回應參數說明

靜態代理訂單

靜態代理訂單模塊提供了靜態IP代理服務的訂購和管理功能。通過這些介面，您可以購買靜態IP代理、管理訂單並完成支付。

功能特點

訂單管理

• 訂單列表
  • 提供詳細的訂單資訊
• 下單
  • 支援批量購買靜態IP
  • 自動計算訂單金額
  • 支援多種支付方式
  • 提供詳細的訂單資訊

支付處理

• 訂單支付
  • 支援多種支付方式
  • 實時支付狀態更新
  • 自動餘額校驗
  • 支付結果通知

使用流程

1. 創建訂單

   • 選擇購買數量和週期
   • 確認訂單金額
   • 聯絡我們確保IP庫存充足（臨時方案，後續會開發介面自主查詢庫存）
   • 提交訂單請求 調用/client/order/addStatic介面
   • 獲取訂單ID 獲取resp.data作為訂單ID

2. 完成支付

   • 使用訂單ID發起支付 調用/client/payment/order/pay/{orderId}介面
   • 選擇支付方式 當前僅支援BALANCE
   • 確認支付結果
   • 查看訂單狀態

使用建議

• 下單前確認所需的靜態IP數量
• 注意檢查帳戶餘額是否充足
• 保存訂單ID以便後續查詢
• 及時確認支付結果狀態
• 如遇支付失敗，查看具體錯誤資訊

新購下單

本介面用於新購下單

介面資訊

POST /client/order/addStatic

請求頭

請求參數

CountryNumsItemVO結構

請求示例

const response = await fetch('/client/order/addStatic', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  },
  body: JSON.stringify({
      "countryNums": [
          {
              "countryCode": "US",
              "num": "2",
              "location" : "New York",
              "ipType":1,
              "ipCategory":"HOST",
              "bandwidth":10
          }
      ],
      "monthCount":1
  })
});

const result = await response.json();

回應結果

{
    "msg": "操作成功",
    "code": 200,
    "data": "N2025032701271232584"
}

帶寬說明

countryNums 中每一項必須傳入 bandwidth（單位 Mbps，常見取值為 5、10）：

• 按指定帶寬計價、校驗庫存並開通；若該地區未設定該帶寬的售價或庫存不足，下單失敗。
• 未傳或傳 null 時介面返回錯誤，例如：countryNums[0].bandwidth不能為空。
• 服務端不會再按 10 Mbps → 5 Mbps 自動選檔。

建議：先調用 可購地區列表查詢，按返回記錄中的 bandwidth、price、ipTotals 下單，並與本介面傳入值保持一致。

注意事項

1. 同一國家/地區若存在多種帶寬規格，必須為每一行 countryNums 顯式傳入目標 bandwidth。

續費下單

本介面用於續費下單，支援批量IP續費。

介面資訊

POST /client/order/renewIpList

請求頭

請求參數

請求示例

const response = await fetch('/client/order/renewIpList', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  },
  body: JSON.stringify({
      "ipList": [
          "43.255.80.100"
      ],
      "monthCount": 1
  })
});

const result = await response.json();

回應結果

{
    "msg": "下單成功",
    "code": 200,
    "data": "N2025032701271232584"
}

退訂下單

本介面用於退訂下單，支援批量IP退訂。

介面資訊

POST /client/order/unsubscribeStaticIps

請求頭

請求參數

請求示例

const response = await fetch('/client/order/unsubscribeStaticIps', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-merchant-token': 'your-token-here',
    'x-merchant-code': 'your-merchant-code'
  },
  body: JSON.stringify({
      "ipList": [
          "43.255.80.100"
      ]
  })
});

const result = await response.json();

回應結果

{
    "msg": "操作成功",
    "code": 200,
    "data": "true"
}

帶寬監控日誌

按機器 IP 與日期範圍查詢帶寬、CPU、內存、TCP 等監控數據，用於不限量代理機器的運行監控與排查。

介面資訊

GET /client/ip/unlimited/log

請求頭

請求參數

代碼示例

/client/ip/unlimited/log?ip=192.168.1.1&startDate=2026-02-27&endDate=2026-02-27

回應示例

{
  "bandwidth": [18, 23, 21, 21, 23, 25],
  "cpu": [13, 16, 15, 16, 16, 17],
  "dates": ["02-27 00:00", "02-27 00:01", "02-27 00:03", "02-27 00:04", "02-27 00:05", "02-27 00:06"],
  "mem": [42, 42, 42, 42, 43, 44],
  "tcp": [49240, 53572, 56375, 54897, 55624, 59692]
}

回應參數說明

數組長度一致，同一索引對應同一時刻的帶寬、CPU、日期、內存、TCP 數據。

訂單服務

通用訂單能力說明。

服務目錄

• 訂單列表
• 訂單支付

訂單列表查詢

查詢已購訂單列表

介面資訊

GET /client/order/orderList

請求頭

請求參數

回應示例

{
  "total": 1,
  "rows": [
    {
      "createTime": "2025-10-22 17:02:52",
      "remark": null,
      "id": 157,
      "merchantId": 1,
      "orderNo": "IPF2025102217025244134",
      "productName": "Static Regular",
      "productType": 2,
      "quantity": 1,
      "totalAmount": 0.010,
      "currency": "CNY",
      "status": 0,
      "paidStatus": 20,
      "payMethod": "ALIPAY",
      "orderItems": [
        {
          "password": "12345678",
          "expireDatetime": "2025-11-21 17:02:53",
          "port": "8080",
          "countryCode": "nz",
          "unsubscribeTime": null,
          "ip": "203.97.15.28",
          "effectiveDatetime": "2025-10-22 17:02:53",
          "days": 30,
          "location": "wellingtont",
          "account": "ipfast@2025",
          "status": "Y"
        }
      ]
    }
  ],
  "code": 200,
  "msg": "查詢成功"
}

回應參數說明

靜態訂單orderItems

訂單支付

支付訂單。

介面資訊

POST /client/payment/order/pay/{orderId}

請求頭

路徑參數

請求參數

請求示例

{
    "payment": "BALANCE"
}

代碼示例

fetch('/client/payment/order/pay/N2025032701271232584', {
    method: 'POST',
    headers: {
        'x-merchant-token': 'your_token',
        'x-merchant-code': 'your_code',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        payment: "BALANCE"
    })
})
.then(response => response.json())
.then(data => console.log(data));

回應示例

{
      "msg": "操作成功",
      "code": 200,
      "data": {
        "paymentType": "BALANCE",
        "paymentName": "餘額支付",
        "orderId": 207,
        "status": 1,
        "payMessage": "success"
      }
}

//錯誤返回
{"msg":"餘額不足","code":500}

回應參數說明

錯誤碼說明

額外說明

部分商品發貨支援Webhook回調通知，詳見IPFast工作臺-我的帳戶-Webhook。