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, 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"]
    }
  ]
}

店铺列表

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

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（MongoDB产品ID）、service（友好服务编号）、description（描述）和imageUrl（图片链接）。可选的productIds参数仅返回这些产品（来自列表的友好服务编号和/或MongoDB产品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 MongoDB ids). Comma-separated, JSON array, or repeated fields. Returns only those products (max 100).	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"

服务列表

获取所有可用服务，支持可选分页。每行包含id（MongoDB实体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 MongoDB 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"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

每行包含id（MongoDB实体ID）、service（用于订单的友好服务编号）、stock（库存）、entityType（smm或product）和autoDelivery（自动交付）。产品行还包含description（描述）和imageUrl（图片链接）。当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

余额

获取您当前的余额。

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. 获取短信订单状态

错误响应

支持的支付方式