API 文件

API 版本：v2

人氣島提供標準 API（v2），讓需要大量下單的行銷團隊、代操公司或開發者，把我們 20+ 平台的社群成長服務串接到自己的網站、系統或機器人：自動下單、查詢訂單進度與帳戶餘額。本文件說明所有可用端點與用法。

API 網址

https://boostisland.com/api/v2

所有請求應透過 POST 或 GET 方法發送到此網址。

身份認證

所有 API 請求都需要使用您的 API 密鑰進行身份驗證。您可以在帳戶設定中找到您的 API 密鑰。每個請求都需要包含 key 參數。

POST https://boostisland.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

回應格式

所有回應都以 JSON 格式回傳。成功的請求會回傳所要求的資料，錯誤則回傳含說明的錯誤物件。

API 端點

取得服務列表

回傳所有可用服務的列表，包括價格、最小和最大數量等詳細資訊。

參數

key - 您的 API 密鑰（必填）
action - "services"

// 回應範例
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

取得餘額

回傳您目前的帳戶餘額和貨幣類型。

參數

key - 您的 API 密鑰（必填）
action - "balance"

// 回應範例
{
  "balance": "100.84292",
  "currency": "USD"
}

建立訂單

為服務建立新訂單。所需參數取決於服務類型。

預設類型

key - 您的 API 密鑰（必填）
action - "add"
service - 服務 ID（必填）
link - 目標連結（必填）
quantity - 訂單數量（必填）

套餐類型

key - 您的 API 密鑰（必填）
action - "add"
service - 服務 ID（必填）
link - 目標連結（必填）

自定義留言類型

key - 您的 API 密鑰（必填）
action - "add"
service - 服務 ID（必填）
link - 目標連結（必填）
comments - 留言內容，用換行符分隔（必填）

// 回應範例
{
  "order": 23501
}

訂單狀態

取得一個或多個訂單的狀態。您可以查詢單個訂單或同時查詢多個訂單。

單個訂單

key - 您的 API 密鑰（必填）
action - "status"
order - 訂單 ID（必填）

多個訂單（最多 100 個）

key - 您的 API 密鑰（必填）
action - "status"
orders - 訂單 ID，用逗號分隔（必填）

// 回應範例
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

建立補單

為訂單申請補單。僅適用於支援補單的服務。

參數

key - 您的 API 密鑰（必填）
action - "refill"
order - 訂單 ID（必填）

// 回應範例
{
  "refill": "1"
}

補單狀態

檢查補單請求的狀態。

參數

key - 您的 API 密鑰（必填）
action - "refill_status"
refill - 補單 ID（必填）

// 回應範例
{
  "status": "Completed"
}

訂單狀態說明

Pending - 訂單等待處理中
Processing - 訂單正在準備中
In progress - 訂單正在執行中
Completed - 訂單已成功完成
Partial - 訂單部分完成（剩餘部分已退款）
Canceled - 訂單已取消

錯誤處理

當發生錯誤時，API 會回傳包含 error 欄位的 JSON 物件，描述具體問題。

// 錯誤回應範例
{
  "error": "Invalid API key"
}

速率限制

為確保服務品質，以下速率限制適用：

每秒 5 個請求
每分鐘 100 個請求
每小時 1000 個請求