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://example.com/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ê các sản phẩm trên marketplace (không bao gồm dịch vụ SMM). Các trường giống như các dòng sản phẩm trong Danh sách Dịch vụ, bao gồm id (mã thực thể sản phẩm), service (số dịch vụ thân thiện), description và imageUrl. Tham số tùy chọn productIds chỉ trả về các sản phẩm đó (số dịch vụ thân thiện từ danh sách và/hoặc mã thực thể sản phẩm, phân cách bằng dấu phẩy hoặc mảng JSON, tối đa 100).

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"

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 và entityType (smm hoặc product). entityType tùy chọn chỉ trả về hàng product hoặc smm. Tham số category và subcategory tùy chọn chỉ trả về dịch vụ trong danh mục hoặc danh mục con đó (giá trị từ API Get Categories). 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ề sản phẩm thị trường phù hợp (dịch vụ SMM bị bỏ qua khi productIds được thiết lập).

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://example.com/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ó:

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.