Ваш 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, subcategory_info, 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"]
    }
  ]
}

Информация о подкатегории

Получить детали подкатегории по subcategoryId, включая родительскую категорию. Используйте subcategoryId из строк списка продуктов.

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

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

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

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

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

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

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

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

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

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"

Самые продаваемые в подкатегории:

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"

Только рекомендуемые товары:

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

Список услуг

Получить все доступные услуги с опциональной пагинацией. Каждая строка содержит id (идентификатор сущности), service (дружественный номер услуги), stock и entityType (smm или product). Опциональный параметр entityType возвращает только строки product или только smm. Опциональные параметры category и subcategory возвращают только услуги в указанной категории или подкатегории (значения из API Get Categories). Опциональный параметр shopId возвращает только товары и услуги для указанного магазина (используйте shopId из Shops List). Опциональный параметр productIds возвращает только соответствующие строки (дружественные номера услуг и/или идентификаторы сущностей; совпадает со строками product или smm). Используйте action=products для фильтрации только товаров.

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

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

Каждая строка включает id (идентификатор сущности) и service (понятный номер услуги для заказов), stock, entityType (smm или product), а также autoDelivery. Строки товаров также содержат description, imageUrl, isRecommended и subcategoryId. Если 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"
  ]
}

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

Создать отмену

Отменить один или несколько заказов (пакетный формат, совместимый с PerfectPanel). Каждый подходящий заказ возмещается на ваш баланс.

Все перечисленные ниже условия должны быть выполнены. Используйте allowcancel для проверки возможности отмены без обработки возврата.

• Досрочная отмена: функция платформы включена (настройка администратора).
• Досрочная отмена: productType имеет значение auto или inventory (автоматические SMM-сервисы обычно используют productType auto).
• Досрочная отмена: статус оплаты — completed или partial.
• Досрочная отмена: статус заказа — pending, processing или error (ошибки провайдера отображаются как in progress).
• Досрочная отмена: отсутствует external_id (заказ еще не отправлен внешнему поставщику или провайдеру).
• Досрочная отмена: прошло не менее N минут с момента завершения оплаты (auto_order_early_refund_minutes, по умолчанию 30).
• Досрочная отмена: клиент еще не использовал досрочный самостоятельный возврат по этому заказу.
• Досрочная отмена: заказ не полностью выполнен (частичная выдача приводит к пропорциональному возмещению за невыполненную часть).
• Досрочная отмена: остается сумма к возврату (refundedAmount меньше общей суммы заказа).
• Досрочная отмена: по заказу нет активного спора.
• Досрочная отмена: нет запроса на вывод средств от поставщика в статусе requested или completed.

Частичная выдача приводит к пропорциональному частичному возврату; выданные аккаунты сохраняются.

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

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

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

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

Разрешить отмену

Проверить, можно ли отменить один или несколько заказов прямо сейчас (те же правила допуска, что и для отмены, но без обработки возврата). Используйте перед вызовом cancel, чтобы избежать неудачных запросов. Поддерживает пакетные ID заказов (через запятую, до 100).

Все перечисленные ниже условия должны быть выполнены. Используйте allowcancel для проверки возможности отмены без обработки возврата.

• Досрочная отмена: функция платформы включена (настройка администратора).
• Досрочная отмена: productType имеет значение auto или inventory (автоматические SMM-сервисы обычно используют productType auto).
• Досрочная отмена: статус оплаты — completed или partial.
• Досрочная отмена: статус заказа — pending, processing или error (ошибки провайдера отображаются как in progress).
• Досрочная отмена: отсутствует external_id (заказ еще не отправлен внешнему поставщику или провайдеру).
• Досрочная отмена: прошло не менее N минут с момента завершения оплаты (auto_order_early_refund_minutes, по умолчанию 30).
• Досрочная отмена: клиент еще не использовал досрочный самостоятельный возврат по этому заказу.
• Досрочная отмена: заказ не полностью выполнен (частичная выдача приводит к пропорциональному возмещению за невыполненную часть).
• Досрочная отмена: остается сумма к возврату (refundedAmount меньше общей суммы заказа).
• Досрочная отмена: по заказу нет активного спора.
• Досрочная отмена: нет запроса на вывод средств от поставщика в статусе requested или completed.

Когда allowcancel равен 1, ответ включает refundAmount (сумму, которую вернула бы отмена).

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

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

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

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

Баланс

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

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

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

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

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