Ваш API ключ

Тест API

Выберите действие, заполните параметры и отправьте запрос. Если вы авторизованы, ваш API-ключ загружается автоматически.

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

Конечная точка API

Все запросы API должны отправляться через HTTP POST на эту конечную точку.

Необязательный язык (lang)

Необязательно. Код целевого языка. Используйте один из поддерживаемых кодов, перечисленных ниже. Если указан и не равен en, переводимые поля возвращаются на этом языке. Если перевод ещё недоступен, API возвращает английский.

Поддерживается для операций чтения: categories, services, products, inventory ((названия подпродуктов)), sms_projects, и sms_countries. Пропустите lang или используйте en для английского.

Параметры фильтрации категорий и подкатегорий для услуг/товаров всегда используют канонические английские названия, даже если установлен язык.

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=categories" \
  -d "lang=zh"

Пример ответа:

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

Список магазинов

Список активных магазинов с основной информацией, количеством товаров и оценками отзывов. Названия магазинов скрыты для конфиденциальности.

Пример запроса:

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), service (дружественный номер услуги), description и imageUrl. Необязательный параметр productIds возвращает только указанные продукты (дружественные номера услуг из списка и/или идентификаторы продуктов MongoDB, разделенные запятыми или JSON-массивом, максимум 100).

Пример запроса:

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), service (понятный номер услуги), stock и entityType (smm или product). Опциональный параметр entityType возвращает только строки product или только smm. Опциональные параметры category и subcategory возвращают только услуги в указанной категории или подкатегории (значения из API Get Categories). Опциональный параметр shopId возвращает только товары и услуги для указанного магазина (используйте shopId из Shops List). Опциональный параметр productIds возвращает только соответствующие товары маркетплейса (услуги SMM опускаются, если указан productIds).

Пример запроса:

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) и service (понятный номер услуги для заказов), stock, entityType (smm или product), а также autoDelivery. Строки продуктов также содержат description и imageUrl. Если limit равен 0 или опущен, возвращаются все услуги, а page/limit равны общему количеству.

Проверить наличие

Получить текущий запас и доступность услуги по её ID (тот же ID, что и в списке услуг). Для продуктов маркетплейса JSON включает субпродукты: массив активных вариантов, каждый из которых содержит subproductId, name и stock (отображаемый запас для этого варианта).

Пример запроса:

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 = поставщик выполняет вручную). Для услуг типа product значения 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.

Пример запроса:

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
}

Статус заказа

Получить статус заказа.

Пример запроса:

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, если заказ выполняется автоматически (например, SMM, товары с авто/инвентаризацией); false, если поставщик должен выполнить вручную (может занять некоторое время).

Пример ответа (заказ продукта с доставленными аккаунтами):

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

Возможные статусы:

Баланс

Получите ваш текущий баланс.

Пример запроса:

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

Пример ответа:

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

SMS Verification API

Выделенные конечные точки для услуг 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"
}

Ответы с ошибками

Распространенные сообщения об ошибках, с которыми вы можете столкнуться.