HstockPlus
HstockPlus/एपीआई दस्तावेज़ीकरण
एपीआई कुंजी प्राप्त करने के लिए लॉगिन करें

आपकी 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.

इन्वेंटरी जांचें

किसी सेवा के आईडी (सेवाओं की सूची में उसी आईडी के अनुसार) के द्वारा वर्तमान स्टॉक और उपलब्धता प्राप्त करें।

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
}

उत्पाद आदेशों (जैसे खाते) के लिए, जब आदेश पूर्ण या आंशिक रूप से वितरित किया जाता है, तो प्रतिक्रिया में वितरित खाता प्रमाण-पत्र (प्रति खाता एक स्ट्रिंग) के साथ एक "खाते" सरणी शामिल होती है। आंशिक वितरण के मामले में, केवल अब तक वितरित किए गए खाते ही लौटाए जाते हैं।

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

एसएमएस सत्यापन सेवाओं के लिए समर्पित एंडपॉइंट्स।

1. एसएमएस प्रोजेक्ट्स प्राप्त करें

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. एसएमएस देश प्राप्त करें

Action: sms_countries

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

3. एसएमएस ऑर्डर बनाएं

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. एसएमएस कोड प्राप्त करें

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. एसएमएस ऑर्डर स्थिति प्राप्त करें

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