新購下單

本介面用於新購下單

介面資訊

POST /client/order/addStatic

請求頭

參數名稱	必選	類型	說明
x-merchant-token	是	string	商戶訪問令牌
x-merchant-code	是	string	商戶編碼

請求參數

參數名稱	必選	類型	說明
countryNums	是	Array of CountryNumsItemVO	國家IP數量分配列表
monthCount	是	Long	購買幾個月

CountryNumsItemVO結構

參數名稱	必選	類型	說明
countryCode	是	String	國家代碼
location	是	String	省/州/區
num	是	Long	該國家需要的IP數量
ipType	是	Long	0：廣播 1：原生
ipCategory	是	String	HOST-住宅 IDC-機房
bandwidth	是	Integer	帶寬規格（Mbps），如 5、10；見下方「帶寬說明」

請求示例

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 下單，並與本介面傳入值保持一致。

注意事項

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

IPFAST HELP