FoxiGrow
返回首页

API 文档

API 版本：v2

FoxiGrow 提供标准的 SMM Panel API，允许您将我们的服务集成到您自己的应用程序中。本文档涵盖所有可用的接口及其使用方法。

API 接口地址

https://foxigrow.com/api/v2

所有请求应通过 POST 或 GET 方法发送到此接口。

身份认证

所有 API 请求都需要使用您的 API 密钥进行身份验证。您可以在账户设置中找到您的 API 密钥。每个请求都需要包含 key 参数。

POST https://foxigrow.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 个请求

技术支持

如果您对 API 有任何疑问，请联系我们的支持团队：

Telegram: @FoxigrowBD