Customer API - HstockPlus

Language

开始使用

HstockPlus/API 文档

登录以获取 API 密钥

您的 API 密钥

加载中...

Test API

Select an action, fill in parameters, and send a request. When logged in, your API key is loaded automatically.

API 密钥

操作

API 端点

https://hstockplus.com/api/v2

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

Get Categories

Get all categories and each category's subcategories. Use these values to filter the Services List by category or subcategory.

Parameter	Description	Required
key	Your API key	Yes
action	categories	Yes

示例请求：

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

示例回复：

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

服务列表

Get all available services with optional pagination. Each service includes stock (available quantity). Optional category and subcategory parameters return only services in that category or subcategory (values from the Get Categories API).

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

示例请求：

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

带分页：

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

Filter by category or subcategory:

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"

示例回复：

{
  "services": [
    {
      "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
    },
    {
      "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
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Each service includes stock (available quantity), entityType (smm or product), and autoDelivery (true if the service/product is auto-delivery, false if manual). When limit is 0 or omitted, all services are returned and page/limit equal total.

检查库存

根据服务ID获取当前库存和可用性（ID与服务列表中的相同）。

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service ID (from services list)	Yes

示例请求：

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

示例回复：

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "entityType": "product",
  "autoDelivery": true
}

Response includes entityType (smm or product) and autoDelivery (true = auto-delivery, false = supplier fulfills manually).

添加订单

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: true if the order is fulfilled automatically (e.g. SMM, auto/inventory products); false if the supplier must fulfill manually (may take some time).

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

{
  "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')

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

2. 获取短信国家

Action: sms_countries

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

3. 创建短信订单

Action: add_sms

Parameter	Description	Required
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
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

{
  "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 密钥

Test API

API 端点

Get Categories

示例请求：

示例回复：

服务列表

示例请求：

示例回复：

检查库存

示例请求：

示例回复：

添加订单

示例请求：

示例回复：

订单状态

示例请求：

示例回复：

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

可能的状态：

余额

示例请求：

示例回复：

SMS Verification API

1. 获取短信项目

2. 获取短信国家

3. 创建短信订单

4. 获取短信验证码

5. 获取短信订单状态

错误响应

Supported payment methods