Khóa API của bạn

Test API

Chọn một hành động, điền tham số và gửi yêu cầu. Khi đã đăng nhập, khóa API của bạn sẽ được tải tự động.

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

Điểm cuối API

Tất cả yêu cầu API nên được gửi qua HTTP POST đến điểm cuối này.

Ngôn ngữ tùy chọn (lang)

Tùy chọn. Mã ngôn ngữ đích. Sử dụng một trong các mã được hỗ trợ được liệt kê bên dưới. Khi được thiết lập và không phải là en, các trường có thể dịch sẽ được trả về bằng ngôn ngữ đó. Nếu bản dịch chưa có sẵn, API sẽ trả về tiếng Anh.

Được hỗ trợ trên các hành động đọc: categories, subcategory_info, services, products, inventory ((tên sản phẩm phụ)), sms_projects, và sms_countries. Bỏ qua lang hoặc dùng en cho tiếng Anh.

Các tham số bộ lọc danh mục và danh mục con trên dịch vụ/sản phẩm luôn sử dụng tên tiếng Anh chuẩn, ngay cả khi lang được thiết lập.

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

Lấy Danh mục

Lấy tất cả danh mục và danh mục con của từng danh mục. Sử dụng các giá trị này để lọc Danh sách Dịch vụ theo danh mục hoặc danh mục con.

Ví dụ Yêu cầu:

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

Ví dụ Phản hồi:

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

Thông tin danh mục con

Lấy thông tin chi tiết danh mục con theo subcategoryId, bao gồm cả danh mục cha. Sử dụng subcategoryId từ các hàng trong Danh sách Sản phẩm.

Ví dụ Yêu cầu:

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

Ví dụ Phản hồi:

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

Danh sách Cửa hàng

Liệt kê các cửa hàng đang hoạt động kèm thông tin cơ bản, số lượng sản phẩm và đánh giá xếp hạng. Tên cửa hàng được ẩn danh để bảo vệ quyền riêng tư.

Ví dụ Yêu cầu:

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

Với phân trang:

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

Danh sách Sản phẩm

Chỉ liệt kê sản phẩm marketplace (không có dịch vụ SMM). Các trường giống như hàng sản phẩm trong Danh sách Dịch vụ, bao gồm id (id thực thể sản phẩm), service (số dịch vụ thân thiện), description và imageUrl. productIds tùy chọn chỉ trả về các sản phẩm đó (số dịch vụ thân thiện từ danh sách và/hoặc id thực thể sản phẩm, phân tách bằng dấu phẩy hoặc mảng JSON, tối đa 100). sort=sold tùy chọn sắp xếp kết quả theo số lượng đơn hàng đã thanh toán giảm dần (sản phẩm bán chạy nhất trước).

Ví dụ Yêu cầu:

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

Lọc theo ID sản phẩm:

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

Với phân trang:

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

Lọc theo danh mục hoặc danh mục con:

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"

Sản phẩm bán chạy nhất trong một danh mục con:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Twitter/X" \
  -d "sort=sold" \
  -d "page=1" \
  -d "limit=10"

Chỉ các sản phẩm được đề xuất:

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

Danh sách Dịch vụ

Lấy tất cả dịch vụ có sẵn với phân trang tùy chọn. Mỗi hàng bao gồm id (id thực thể), service (số dịch vụ thân thiện), stock (tồn kho) và entityType (smm hoặc product). Tham số entityType tùy chọn chỉ trả về hàng product hoặc smm. Tham số danh mục và danh mục con tùy chọn chỉ trả về dịch vụ trong danh mục hoặc danh mục con đó (giá trị từ API Lấy Danh mục). Tham số shopId tùy chọn chỉ trả về sản phẩm và dịch vụ cho cửa hàng đó (sử dụng shopId từ Danh sách Cửa hàng). Tham số productIds tùy chọn chỉ trả về các hàng phù hợp (số dịch vụ thân thiện và/hoặc id thực thể; khớp với hàng sản phẩm hoặc smm). Sử dụng action=products để chỉ lọc sản phẩm.

Ví dụ Yêu cầu:

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

Với phân trang:

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

Lọc theo danh mục hoặc danh mục con:

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"

Lọc theo loại thực thể:

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

Ví dụ Phản hồi:

{
  "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://cdn.hstockplus.org/uploads/products/gmail.webp",
      "isRecommended": true,
      "subcategoryId": "674a1f77bcf86cd799439099"
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Mỗi hàng bao gồm id (mã thực thể) và service (số dịch vụ thân thiện cho đơn hàng), stock, entityType (smm hoặc product), và autoDelivery. Các hàng sản phẩm cũng bao gồm description, imageUrl, isRecommended, và subcategoryId. Khi limit là 0 hoặc bị bỏ qua, tất cả dịch vụ được trả về và page/limit bằng tổng số.

Kiểm tra Tồn kho

Lấy thông tin tồn kho và tình trạng sẵn có hiện tại của một dịch vụ theo ID của nó (cùng ID như trong danh sách dịch vụ). Đối với các sản phẩm trên thị trường, JSON bao gồm các sản phẩm phụ: một mảng các biến thể đang hoạt động, mỗi biến thể có subproductId, tên và tồn kho (hiển thị tồn kho cho biến thể đó).

Ví dụ Yêu cầu:

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

Ví dụ Phản hồi (SMM):

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

Ví dụ phản hồi (sản phẩm):

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

Phản hồi bao gồm tỷ lệ (trên mỗi đơn vị, cùng định dạng chuỗi như danh sách dịch vụ), entityType (smm hoặc product) và autoDelivery (true = tự động giao hàng, false = nhà cung cấp thực hiện thủ công). Đối với dịch vụ sản phẩm, min và max khớp với hàng sản phẩm phụ chính trong danh sách dịch vụ; nếu sản phẩm phụ đó không thể đáp ứng đơn đặt hàng của bạn, nền tảng có thể chọn một sản phẩm phụ khác và tính giá đơn vị của nó. Mảng subproducts liệt kê mọi biến thể đang hoạt động với tồn kho hiển thị; phản hồi tồn kho SMM bỏ qua 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.

Ví dụ Yêu cầu:

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"

Ví dụ Phản hồi:

{
  "order": 23501
}

Trạng thái đơn hàng

Lấy trạng thái của một đơn hàng.

Ví dụ Yêu cầu:

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

Ví dụ Phản hồi:

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

Đối với đơn hàng sản phẩm (ví dụ: tài khoản), khi đơn hàng được giao toàn bộ hoặc một phần, phản hồi bao gồm một mảng "accounts" chứa thông tin đăng nhập tài khoản đã giao (một chuỗi cho mỗi tài khoản). Đối với giao hàng một phần, chỉ các tài khoản đã giao cho đến thời điểm đó được trả về.

autoDelivery: true nếu đơn hàng được xử lý tự động (ví dụ: SMM, sản phẩm tự động/tồn kho); false nếu nhà cung cấp phải xử lý thủ công (có thể mất một thời gian).

Ví dụ Phản hồi (đơn hàng sản phẩm với tài khoản đã giao):

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

Các Trạng thái Có thể có:

Tạo hủy

Hủy một hoặc nhiều đơn hàng (định dạng batch tương thích với PerfectPanel). Mỗi đơn hàng đủ điều kiện sẽ được hoàn tiền vào số dư của bạn.

Tất cả những điều sau đây phải đúng. Sử dụng allowcancel để kiểm tra điều kiện đủ mà không cần xử lý hoàn tiền.

• Hủy sớm: tính năng nền tảng được bật (cài đặt quản trị viên).
• Early cancel: productType is manual, auto, or inventory (SMM auto services typically use productType auto).
• Hủy sớm: trạng thái thanh toán là hoàn tất hoặc một phần.
• Hủy sớm: trạng thái đơn hàng là đang chờ, đang xử lý hoặc lỗi (lỗi từ nhà cung cấp hiển thị là đang tiến hành).
• Hủy sớm: không có external_id (đơn hàng chưa được gửi đến nhà cung cấp hoặc đối tác bên ngoài).
• Hủy sớm: ít nhất N phút kể từ khi thanh toán hoàn tất (auto_order_early_refund_minutes, mặc định 30).
• Hủy sớm: khách hàng chưa từng sử dụng tính năng tự hoàn tiền sớm cho đơn hàng này.
• Hủy sớm: đơn hàng chưa được giao đầy đủ (giao một phần sẽ được hoàn tiền tương ứng cho phần chưa giao).
• Hủy sớm: số tiền hoàn lại vẫn còn (refundedAmount nhỏ hơn tổng đơn hàng).
• Hủy sớm: không có tranh chấp đang hoạt động trên đơn hàng.
• Hủy sớm: không có nhà cung cấp nào rút lui ở trạng thái đã yêu cầu hoặc đã hoàn tất.

Giao hàng một phần sẽ được hoàn tiền tương ứng; các tài khoản đã giao vẫn được giữ lại.

Ví dụ Yêu cầu:

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

Ví dụ Phản hồi:

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

Cho phép hủy

Kiểm tra xem một hoặc nhiều đơn hàng có thể bị hủy ngay bây giờ không (cùng quy tắc đủ điều kiện như hủy, nhưng không xử lý hoàn tiền). Sử dụng trước khi gọi hủy để tránh các yêu cầu thất bại. Hỗ trợ ID đơn hàng hàng loạt (cách nhau bằng dấu phẩy, tối đa 100).

Tất cả những điều sau đây phải đúng. Sử dụng allowcancel để kiểm tra điều kiện đủ mà không cần xử lý hoàn tiền.

• Hủy sớm: tính năng nền tảng được bật (cài đặt quản trị viên).
• Early cancel: productType is manual, auto, or inventory (SMM auto services typically use productType auto).
• Hủy sớm: trạng thái thanh toán là hoàn tất hoặc một phần.
• Hủy sớm: trạng thái đơn hàng là đang chờ, đang xử lý hoặc lỗi (lỗi từ nhà cung cấp hiển thị là đang tiến hành).
• Hủy sớm: không có external_id (đơn hàng chưa được gửi đến nhà cung cấp hoặc đối tác bên ngoài).
• Hủy sớm: ít nhất N phút kể từ khi thanh toán hoàn tất (auto_order_early_refund_minutes, mặc định 30).
• Hủy sớm: khách hàng chưa từng sử dụng tính năng tự hoàn tiền sớm cho đơn hàng này.
• Hủy sớm: đơn hàng chưa được giao đầy đủ (giao một phần sẽ được hoàn tiền tương ứng cho phần chưa giao).
• Hủy sớm: số tiền hoàn lại vẫn còn (refundedAmount nhỏ hơn tổng đơn hàng).
• Hủy sớm: không có tranh chấp đang hoạt động trên đơn hàng.
• Hủy sớm: không có nhà cung cấp nào rút lui ở trạng thái đã yêu cầu hoặc đã hoàn tất.

Khi allowcancel là 1, phản hồi sẽ bao gồm refundAmount (số tiền sẽ được hoàn lại khi hủy).

Ví dụ Yêu cầu:

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

Ví dụ Phản hồi:

[
  {
    "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"
  }
]

Số dư

Lấy số dư hiện tại của bạn.

Ví dụ Yêu cầu:

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

Ví dụ Phản hồi:

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

SMS Verification API

Các điểm cuối chuyên dụng cho dịch vụ xác minh SMS.

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

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

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

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

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

Phản hồi Lỗi

Các phản hồi lỗi phổ biến bạn có thể gặp phải.