Customer API - HstockPlus

开始使用

HstockPlus/API 文档

登录以获取 API 密钥

您的 API 密钥

加载中...

测试 API

选择一个操作，填写参数，然后发送请求。登录后，您的 API 密钥会自动加载。

API 密钥

语言（可选）

行动

请求命令

当您更改操作或参数时自动更新。

curl -X POST "https://hstockplus.com/api/v2" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=categories"

API 端点

https://hstockplus.com/api/v2

所有 API 请求均应通过 HTTP POST 方式发送至此端点。

可选语言（lang）

可选。目标语言代码。使用下方列出的支持代码之一。当设置为非 en 时，可翻译字段将以该语言返回。如果翻译尚不可用，API 将返回英文。

支持的语言代码

zhesfrdejakoptpt-BRruarhiviurbn-BDen(默认 — 省略 lang 或使用 en)

为 lang 参数使用这些精确值。别名：jp 可接受为 ja。

支持读取操作： categories, subcategory_info, services, products, inventory ((子产品名称)), sms_projects, 和 sms_countries. 省略语言或使用en表示英语。

服务/产品上的category和subcategory筛选参数始终使用规范英文名称，即使设置了lang也是如此。

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

获取类别

获取所有类别及每个类别的子类别。使用这些值按类别或子类别筛选服务列表。

Parameter	Description	Required
key	Your API key	Yes
action	categories	Yes
lang	可选语言代码。请参阅上方“可选语言 (lang)”中的支持代码。	No

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=categories" \
  -d "lang=zh"

示例回复：

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

子类别信息

通过subcategoryId获取子类别详情，包括父类别。使用产品列表行中的subcategoryId。

Parameter	Description	Required
key	Your API key	Yes
action	subcategory_info	Yes
subcategoryId	Subcategory ID from Products List	Yes
lang	可选语言代码。请参阅上方“可选语言 (lang)”中的支持代码。	No

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=subcategory_info" \
  -d "subcategoryId=674a1f77bcf86cd799439099" \
  -d "lang=zh"

示例回复：

{
  "subcategoryId": "674a1f77bcf86cd799439099",
  "name": "Gmail",
  "slug": "gmail",
  "imageUrl": "https://example.com/uploads/subcategories/gmail.webp",
  "description": "Verified Gmail accounts",
  "category": {
    "categoryId": "674a1f77bcf86cd799439088",
    "name": "Email Accounts",
    "slug": "email-accounts"
  }
}

店铺列表

列出活跃店铺的基本信息、商品数量及评价星级。店铺名称已做隐私处理。

Parameter	Description	Required
key	Your API key	Yes
action	shops	Yes
page	Page number (default 1).	No
limit	Items per page (default 20).	No

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

带分页：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops" \
  -d "page=1" \
  -d "limit=20"

产品列表

仅列出市场产品（不含SMM服务）。字段与服务列表中的产品行相同，包括id（产品实体ID）、service（友好服务编号）、description和imageUrl。可选的productIds参数仅返回指定产品（来自列表的友好服务编号和/或产品实体ID，以逗号分隔或JSON数组形式，最多100个）。

Parameter	Description	Required
key	Your API key	Yes
action	products	Yes
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	Filter by category name (from Get Categories). Returns only products in this category.	No
subcategory	Filter by subcategory name (from Get Categories). Returns only products in this subcategory.	No
shopId	Filter by shop ID (from Shops List). Returns only that shop's products.	No
productIds	Optional list of product IDs (service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns only those products (max 100).	No
isRecommended	可选。设置为 true 时，仅返回 isRecommended === true 的产品。	No
lang	可选语言代码。请参阅上方“可选语言 (lang)”中的支持代码。	No

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products"

按产品ID筛选：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "productIds=2,5,9"

带分页：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "page=1" \
  -d "limit=50"

按类别或子类别筛选：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

仅推荐产品：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "isRecommended=true"

服务列表

获取所有可用服务，支持可选分页。每行包含id（实体ID）、service（友好服务编号）、stock（库存）和entityType（smm或product）。可选的entityType参数仅返回product或smm行。可选的category和subcategory参数仅返回该类别或子类别中的服务（值来自获取类别API）。可选的shopId参数仅返回该店铺的产品和服务（使用店铺列表中的shopId）。可选的productIds参数仅返回匹配的市场产品（当设置productIds时，SMM服务将被忽略）。

Parameter	Description	Required
key	Your API key	Yes
action	services	Yes
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	Filter by category name (from Get Categories). Returns only services in this category.	No
subcategory	Filter by subcategory name (from Get Categories). Returns only services in this subcategory.	No
shopId	Filter by shop ID (from Shops List). Returns only that shop's products and SMM services.	No
entityType	可选筛选条件：product或smm。仅返回市场产品或仅返回SMM服务。	No
productIds	Optional list of product IDs (service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns only those products; SMM rows are omitted.	No
lang	可选语言代码。请参阅上方“可选语言 (lang)”中的支持代码。	No

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

带分页：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

按类别或子类别筛选：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

按实体类型筛选：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "entityType=product"

示例回复：

{
  "services": [
    {
      "id": "507f1f77bcf86cd799439011",
      "service": 1,
      "name": "Instagram Followers",
      "type": "Default",
      "category": "Instagram",
      "rate": "0.50",
      "min": 100,
      "max": 10000,
      "refill": true,
      "cancel": false,
      "stock": 10000,
      "entityType": "smm",
      "autoDelivery": true
    },
    {
      "id": "507f1f77bcf86cd799439012",
      "service": 2,
      "name": "Gmail Account - USA",
      "type": "Default",
      "category": "Accounts-Email",
      "rate": "25.00",
      "min": 1,
      "max": 50,
      "refill": false,
      "cancel": false,
      "stock": 50,
      "entityType": "product",
      "autoDelivery": true,
      "description": "Verified Gmail account with recovery email",
      "imageUrl": "https://example.com/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

每行包含 id（实体 ID）和 service（订单友好服务编号）、stock、entityType（smm 或 product）以及 autoDelivery。产品行还包含 description、imageUrl、isRecommended 和 subcategoryId。当 limit 为 0 或省略时，返回所有服务，且 page/limit 等于总数。

检查库存

通过服务ID（与服务列表中的ID相同）获取当前库存和可用性。对于市场产品，JSON包含subproducts：活跃变体数组，每个变体包含subproductId、名称和库存（该变体的显示库存）。

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service ID (from services list)	Yes
lang	可选语言代码。请参阅上方“可选语言 (lang)”中的支持代码。	No

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

示例回复（SMM）：

{
  "service": 1,
  "stock": 10000,
  "available": true,
  "rate": "0.5000",
  "entityType": "smm",
  "autoDelivery": true
}

示例回复（产品）：

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "rate": "25.0000",
  "min": 1,
  "max": 42,
  "entityType": "product",
  "autoDelivery": true,
  "subproducts": [
    { "subproductId": "674a1f77bcf86cd799439011", "name": "1 Month", "stock": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0 }
  ]
}

响应包含rate（单价，字符串格式与服务列表相同）、entityType（smm或product）和autoDelivery（true=自动发货，false=供应商手动处理）。对于产品服务，min和max匹配服务列表中的主要子产品行；如果该子产品无法满足您的加单需求，平台可能选择其他子产品并按其实时单价收费。subproducts数组列出所有活跃变体及其显示库存；SMM库存响应不包含subproducts。

添加订单

Place a standard order with link and quantity. Link: for SMM services (e.g. followers, likes) — required, use the URL to the content (e.g. Instagram post); for product orders (e.g. accounts) — optional, if empty the system uses your account email for delivery.

Parameter	Description	Required
key	Your API key	Yes
action	add	Yes
service	Service ID	Yes
link	Link: For SMM orders (e.g. followers, likes, comments): required — URL or link to the content (e.g. Instagram post URL). For product orders (e.g. accounts): optional — delivery email or reference; if empty, the system uses your account email.	No
quantity	Quantity to order	Yes

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

示例回复：

{
  "order": 23501
}

订单状态

获取订单状态。

Parameter	Description
key	Your API key
action	status
order	Order ID

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=23501"

示例回复：

{
  "status": "In progress",
  "charge": "5.00",
  "start_count": 1000,
  "remains": 500,
  "currency": "USD",
  "autoDelivery": true
}

对于产品订单（例如账户），当订单完全或部分交付时，响应中会包含一个"accounts"数组，其中包含已交付的账户凭据（每个账户一个字符串）。对于部分交付，仅返回目前已交付的账户。

autoDelivery：如果订单自动完成（例如 SMM、自动/库存产品），则为 true；如果供应商必须手动完成（可能需要一些时间），则为 false。

示例响应（已交付账户的产品订单）：

{
  "status": "Completed",
  "charge": "10.00",
  "start_count": 5,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": true,
  "accounts": [
    "user1:pass1",
    "user2:pass2"
  ]
}

可能的状态：

PendingIn progressCompletedPartialCanceled

创建取消

取消一个或多个订单（兼容PerfectPanel的批量格式）。每个符合条件的订单将退款至您的余额。

以下所有条件必须为真。使用 allowcancel 检查资格，无需处理退款。

提前取消：平台功能已启用（管理员设置）。
提前取消：productType 为 auto 或 inventory（SMM 自动服务通常使用 productType auto）。
提前取消：支付状态为已完成或部分完成。
提前取消：订单状态为待处理、处理中或错误（供应商错误显示为进行中）。
提前取消：无外部ID（订单尚未发送至外部供应商或服务商）。
提前取消：自支付完成起至少N分钟（auto_order_early_refund_minutes，默认30分钟）。
提前取消：该订单尚未使用过提前自助退款。
提前取消：订单未完全交付（部分交付时，未交付部分按比例退款）。
提前取消：可退款金额保持不变（退款金额低于订单总额）。
提前取消：订单无有效争议。
提前取消：请求中或已完成状态的供应商无法撤回。

部分发货将按比例进行部分退款；已交付的账户予以保留。

Parameter	Description
key	Your API key
action	cancel
orders	订单ID（以逗号分隔，最多100个ID）

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=cancel" \
  -d "orders=23501,23502"

示例回复：

[
  {
    "order": 23501,
    "cancel": 1
  },
  {
    "order": 23502,
    "cancel": {
      "error": "Incorrect order ID"
    }
  }
]

允许取消

检查一个或多个订单当前是否可取消（与取消相同的资格规则，但不处理退款）。在调用取消前使用此功能以避免请求失败。支持批量订单ID（以逗号分隔，最多100个）。

以下所有条件必须为真。使用 allowcancel 检查资格，无需处理退款。

提前取消：平台功能已启用（管理员设置）。
提前取消：productType 为 auto 或 inventory（SMM 自动服务通常使用 productType auto）。
提前取消：支付状态为已完成或部分完成。
提前取消：订单状态为待处理、处理中或错误（供应商错误显示为进行中）。
提前取消：无外部ID（订单尚未发送至外部供应商或服务商）。
提前取消：自支付完成起至少N分钟（auto_order_early_refund_minutes，默认30分钟）。
提前取消：该订单尚未使用过提前自助退款。
提前取消：订单未完全交付（部分交付时，未交付部分按比例退款）。
提前取消：可退款金额保持不变（退款金额低于订单总额）。
提前取消：订单无有效争议。
提前取消：请求中或已完成状态的供应商无法撤回。

当 allowcancel 为 1 时，响应中包含 refundAmount（取消操作将退还的金额）。

Parameter	Description
key	Your API key
action	allowcancel
orders	订单ID（以逗号分隔，最多100个ID）

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=allowcancel" \
  -d "orders=23501,23502"

示例回复：

[
  {
    "order": 23501,
    "allowcancel": 1,
    "refundAmount": 5.00
  },
  {
    "order": 23502,
    "allowcancel": 0,
    "error": "Early auto refund is not available for this order",
    "reason": "BEFORE_MIN_WAIT",
    "eligibleAfter": "2026-06-23T12:30:00.000Z"
  }
]

余额

获取您当前的余额。

Parameter	Description
key	Your API key
action	balance

示例请求：

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

示例回复：

{
  "balance": "100.00",
  "currency": "USD"
}

SMS Verification API

短信验证服务的专用端点。

1. 获取短信项目

Action: sms_projects

Parameter	Description
key	Your API key
action	sms_projects
country	Optional. Filter by country ID (e.g. 'us', 'gb')
lang	可选语言代码。请参阅上方“可选语言 (lang)”中的支持代码。

[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

2. 获取短信国家

Action: sms_countries

Parameter	Description
key	Your API key
action	sms_countries
lang	可选语言代码。请参阅上方“可选语言 (lang)”中的支持代码。

[
  {
    "country_code": "us",
    "country_name": "United States"
  },
  {
    "country_code": "gb",
    "country_name": "United Kingdom"
  }
]

3. 创建短信订单

Action: add_sms

Parameter	Description	Required
key	Your API key
action	add_sms
project_id	Project ID from sms_projects	Yes
quantity	Number of numbers (1-10)	No (Default 1)
country	Country code (e.g. 'us')	No
phone	Phone number to reuse	No

{
  "orders": [
    {
      "order": 12345,
      "phone": "+1234567890",
      "country": "us",
      "status": "active"
    }
  ]
}

4. 获取短信验证码

Action: sms_code

Parameter	Description
key	Your API key
action	sms_code
order	Order ID

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}

5. 获取短信订单状态

Action: sms_status

Parameter	Description
key	Your API key
action	sms_status
order	Order ID

{
  "status": "code_received",
  "phone": "+1234567890",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "expires_at": "2023-01-01T12:00:00.000Z"
}

错误响应

您可能会遇到的常见错误响应。

{"error": "Invalid API key"}

{"error": "Invalid action"}

{"error": "Service ID is required"}

{"error": "Insufficient balance"}

{"error": "Order not found"}

{"error": "Service not found"}

需要帮助？请通过以下方式联系我们： support@hstockplus.net

您的 API 密钥

测试 API

API 端点

可选语言（lang）

获取类别

示例请求：

示例回复：

子类别信息

示例请求：

示例回复：

店铺列表

示例请求：

产品列表

示例请求：

服务列表

示例请求：

示例回复：

检查库存

示例请求：

示例回复（SMM）：

示例回复（产品）：

添加订单

示例请求：

示例回复：

订单状态

示例请求：

示例回复：

示例响应（已交付账户的产品订单）：

可能的状态：

创建取消

示例请求：

示例回复：

允许取消

示例请求：

示例回复：

余额

示例请求：

示例回复：

SMS Verification API

1. 获取短信项目

2. 获取短信国家

3. 创建短信订单

4. 获取短信验证码

5. 获取短信订单状态

错误响应

支持的支付方式