HstockPlus
HstockPlus/Документация API
Войдите, чтобы получить API-ключ

Ваш API ключ

Загрузка...

Test API

Select an action, fill in parameters, and send a request. When logged in, your API key is loaded automatically.

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

https://hstockplus.com/api/v2

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

Get Categories

Get all categories and each category's subcategories. Use these values to filter the Services List by category or subcategory.

ParameterDescriptionRequired
keyYour API keyYes
actioncategoriesYes

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

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

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

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

Список услуг

Get all available services with optional pagination. Each service includes stock (available quantity). Optional category and subcategory parameters return only services in that category or subcategory (values from the Get Categories API).

ParameterDescriptionRequired
keyYour API keyYes
actionservicesYes
pagePage number (default 1). Used when limit > 0.No
limitItems per page (default 0 = return all).No
categoryFilter by category name (from Get Categories). Returns only services in this category.No
subcategoryFilter by subcategory name (from Get Categories). Returns only services in this subcategory.No

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

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

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

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

Filter by category or subcategory:

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"

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

{
  "services": [
    {
      "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
    },
    {
      "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
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Each service includes stock (available quantity), entityType (smm or product), and autoDelivery (true if the service/product is auto-delivery, false if manual). When limit is 0 or omitted, all services are returned and page/limit equal total.

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

Получите текущий запас и доступность услуги по её ID (тот же ID, что и в списке услуг).

ParameterDescriptionRequired
keyYour API keyYes
actioninventoryYes
serviceService ID (from services list)Yes

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

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

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

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "entityType": "product",
  "autoDelivery": true
}

Response includes entityType (smm or product) and autoDelivery (true = auto-delivery, false = supplier fulfills manually).

Добавить заказ

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.

ParameterDescriptionRequired
keyYour API keyYes
actionaddYes
serviceService IDYes
linkLink: For SMM orders (e.g. followers, likes, comments): required — URL or link to the content (e.g. Instagram post URL). For product orders (e.g. accounts): optional — delivery email or reference; if empty, the system uses your account email.No
quantityQuantity to orderYes

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

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
}

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

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

ParameterDescription
keyYour API key
actionstatus
orderOrder ID

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

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 if the order is fulfilled automatically (e.g. SMM, auto/inventory products); false if the supplier must fulfill manually (may take some time).

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

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

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

PendingIn progressCompletedPartialCanceled

Баланс

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

ParameterDescription
keyYour API key
actionbalance

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

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-верификации.

1. Получить SMS-проекты

Action: sms_projects

ParameterDescription
keyYour API key
actionsms_projects
countryOptional. Filter by country ID (e.g. 'us', 'gb')
[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

2. Получить страны для SMS

Action: sms_countries

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

3. Создать SMS-заказ

Action: add_sms

ParameterDescriptionRequired
project_idProject ID from sms_projectsYes
quantityNumber of numbers (1-10)No (Default 1)
countryCountry code (e.g. 'us')No
phonePhone number to reuseNo
{
  "orders": [
    {
      "order": 12345,
      "phone": "+1234567890",
      "country": "us",
      "status": "active"
    }
  ]
}

4. Получить SMS-код

Action: sms_code

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

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

Action: sms_status

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

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

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

{"error": "Invalid API key"}
{"error": "Invalid action"}
{"error": "Service ID is required"}
{"error": "Insufficient balance"}
{"error": "Order not found"}
{"error": "Service not found"}

Нужна помощь? Свяжитесь с нами по адресу support@hstockplus.net

Supported payment methods

Supported payment methods
Customer API - HstockPlus | HstockPlus