Документация API

Ваш API-ключ

Тест API

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

curl -X POST "https://hstockplus.net/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.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

Получить категории

Получить все категории и подкатегории каждой категории. Используйте эти значения для фильтрации списка услуг по категории или подкатегории.

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

curl -X POST https://hstockplus.net/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.net/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.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

С пагинацией:

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

Список купонов

Список купонов всех магазинов, которые можно использовать прямо сейчас, с условиями каждого. Передайте код как coupon в action=add. Коды, созданные только для вашего аккаунта (например, оптовое предложение из тикета), включены и помечены как private.

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

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

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

{
  "coupons": [
    {
      "code": "SAVE10",
      "type": "percentage",
      "value": 10,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "shop",
      "minPurchase": 20,
      "remainingUses": 87,
      "expiresAt": "2026-11-30T23:59:59.000Z"
    },
    {
      "code": "BULK500",
      "type": "percentage",
      "value": 5,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "services",
      "services": [110469, 110470],
      "minQuantity": 100,
      "quantityTiers": [
        { "minQuantity": 100, "value": 5 },
        { "minQuantity": 500, "value": 12 }
      ],
      "maxUsesPerUser": 1,
      "remainingUses": 40
    }
  ],
  "total": 2
}

Купон вычитается из суммы, оставшейся после скидки реселлера. Необязательные поля опускаются, если у купона нет соответствующего условия.

Список товаров

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

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

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

Фильтр по ID товаров:

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

С пагинацией:

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

Фильтр по категории или подкатегории:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

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

curl -X POST https://hstockplus.net/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.net/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.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

С пагинацией:

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

Фильтр по категории или подкатегории:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

Фильтр по типу сущности:

curl -X POST https://hstockplus.net/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",
      "sold": 5300,
      "sellerRating": 4.0,
      "sellerReviewCount": 30,
      "returningBuyerRate": 0.52,
      "warrantyHours": 12
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Каждая строка включает id (идентификатор сущности) и service (понятный номер услуги для заказов), stock, entityType (smm или product), а также autoDelivery. Строки товаров также содержат description, imageUrl, isRecommended и subcategoryId. Если limit равен 0 или опущен, возвращаются все услуги, а page/limit равны общему количеству.

Строки товаров также содержат данные со страницы товара: service — номер товара (#48071 на странице), sellerRating и sellerReviewCount — звёздный рейтинг продавца и число отзывов о нём, returningBuyerRate — доля повторных покупателей продавца (0.52 = 52%), sold — число проданных единиц, warrantyHours — срок послепродажной поддержки в часах с момента доставки (0 = без поддержки). sellerRating, sellerReviewCount и returningBuyerRate опускаются, если у продавца нет рейтинга или слишком мало покупателей.

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

Возвращает текущий запас и доступность услуги по её ID (тот же ID, что и в списке услуг). Для товаров маркетплейса в JSON есть subproducts: массив активных вариантов, у каждого subproductId, name, stock (отображаемый запас варианта) и собственные цена и лимиты заказа: available, rate, min, max, а для вариантов, продаваемых фиксированными пакетами, ещё и packs.

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

curl -X POST https://hstockplus.net/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, "available": true, "rate": "25.0000", "min": 1, "max": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0, "available": false, "rate": "60.0000", "min": 1, "max": 0 },
    {
      "subproductId": "674a1f77bcf86cd799439013", "name": "Pack", "stock": 500, "available": true, "rate": "0.0190", "min": 100, "max": 100,
      "packs": [
        { "quantity": 100, "price": "1.9000", "discountPercent": 5 },
        { "quantity": 500, "price": "9.0000", "discountPercent": 10 }
      ]
    }
  ],
  "warrantyHours": 24
}

Ответ включает rate (за единицу, в том же строковом формате, что и список услуг), entityType (smm или product) и autoDelivery (true = автоматическая доставка, false = поставщик выполняет вручную). Для услуг типа product значения min и max соответствуют основной строке подпродукта в списке услуг; если этот подпродукт не может выполнить ваш дополнительный заказ, платформа может выбрать другой подпродукт и взимать его цену за единицу. Массив subproducts содержит список всех активных вариантов с отображаемым остатком; ответы по инвентаризации SMM не включают subproducts.

У каждого подтовара свои rate, min и max: это цена за единицу и диапазон количества, по которым add списывает средства при передаче этого subproductId, до учёта скидки реселлера на вашем аккаунте. Для вариантов, продаваемых фиксированными пакетами, packs перечисляет каждый пакет в наличии (quantity, общая цена, discountPercent), и заказывать нужно одно из этих количеств; rate, min и max при этом описывают самый маленький пакет.

warrantyHours (products only) is the product's after-sales window in hours counted from delivery, the same figure as in the services list; 0 means no after-sales.

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. For products with multiple options (Select Option on the website), pass subproductId (from action=inventory) to choose which option to order — otherwise the default option is used.

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

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

# Product with multiple options: pick the subproductId from action=inventory
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=1" \
  -d "subproductId=674a1f77bcf86cd799439012"

# With a coupon code from action=coupons
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=10" \
  -d "coupon=SAVE10"

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

{
  "order": 23501,
  "entityType": "product",
  "charge": "22.5000",
  "couponDiscount": "2.5000",
  "warrantyHours": 24
}

charge is what was taken from your balance. couponDiscount is present only when a coupon was applied. warrantyHours (products only) is the after-sales window in hours counted from delivery, 0 = no after-sales; action=status returns the exact end time as warranty_expires_at.

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

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

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

curl -X POST https://hstockplus.net/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"
  ]
}

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

Возвращённый заказ получает статус Canceled, частично возвращённый — Partial. Если были возвращены деньги, в ответе также есть поле "refunded" с суммой возврата в USD.

Пример ответа (заказ товара доставлен файлами):

Некоторые товары (например, аккаунты Telegram с архивами сессий) доставляются ZIP-файлами вместо текстовых данных или вместе с ними. Тогда в ответе есть массив "files". Каждый файл — это один доставленный элемент. Скачать файл можно через action=order_file.

{
  "status": "Completed",
  "charge": "12.00",
  "start_count": 0,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": false,
  "files": [
    {
      "id": "66e6b2f0c3a1d2e4f5a6b7c8",
      "name": "sessions-001.zip",
      "size": 482113,
      "uploaded_at": "2026-09-15T08:30:00.000Z"
    }
  ]
}

Скачать файл заказа

Скачивает один файл доставки (ZIP) вашего заказа. При успехе тело ответа — сам файл (Content-Type: application/zip); при ошибке — JSON с полем "error".

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

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=order_file" \
  -d "order=23501" \
  -d "file=66e6b2f0c3a1d2e4f5a6b7c8" \
  -o sessions-001.zip

Пример ответа с ошибкой:

{
  "error": "File not found"
}

Перед сохранением проверьте заголовок Content-Type: application/zip означает файл, application/json — ошибку.

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

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

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

• Досрочная отмена: функция платформы включена (настройка администратора).
• Досрочная отмена: productType — manual, 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.net/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 — manual, 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.net/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.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

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

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

API SMS-верификации

Выделенные конечные точки для услуг SMS-верификации.

У SMS-заказов собственные ID. Для них используйте sms_code, sms_status и sms_cancel; status, cancel и allowcancel работают только с заказами товаров и SMM.

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

[
  {
    "country_code": "+1",
    "country_name": "United States"
  },
  {
    "country_code": "+44",
    "country_name": "United Kingdom"
  }
]

{
  "orders": [
    {
      "order": 12345,
      "phone": "4055123415",
      "dial_code": "+1",
      "phone_full": "+14055123415",
      "country": "US",
      "expires_at": "2026-01-01T12:15:00.000Z",
      "status": "active"
    }
  ]
}

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}
// OR, once expires_at has passed without a code (call sms_cancel for a refund)
{
  "status": "expired",
  "message": "No code arrived before the number expired. Call action=sms_cancel for a refund."
}

{
  "status": "code_received",
  "phone": "4055123415",
  "dial_code": "+1",
  "phone_full": "+14055123415",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "refunded": false,
  "expires_at": "2026-01-01T12:15:00.000Z"
}
// status: phone_acquired | code_received | expired | released

{
  "order": 12345,
  "status": "cancelled",
  "refunded": true,
  "refund_amount": "0.5000",
  "currency": "USD"
}
// OR
{
  "error": "Verification code already received, cannot release"
}

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

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