Customer API - 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 कुंजी

कार्रवाई

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.

Parameter	Description	Required
key	Your API key	Yes
action	categories	Yes

उदाहरण अनुरोध:

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).

Parameter	Description	Required
key	Your API key	Yes
action	services	Yes
page	Page number (default 1). Used when limit > 0.	No
limit	Items per page (default 0 = return all).	No
category	Filter by category name (from Get Categories). Returns only services in this category.	No
subcategory	Filter 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
    },
    {
      "service": 2,
      "name": "Instagram Comments",
      "type": "Custom Comments",
      "category": "Instagram",
      "rate": "5.00",
      "min": 10,
      "max": 1000,
      "refill": false,
      "cancel": false,
      "stock": 1000
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

प्रत्येक सेवा में स्टॉक (उपलब्ध मात्रा) शामिल है। जब सीमा 0 है या छोड़ी गई है, तो सभी सेवाएं लौटाई जाती हैं और पृष्ठ/सीमा कुल के बराबर होती है।

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

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

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service 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
}

ऑर्डर जोड़ें

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.

Parameter	Description	Required
key	Your API key	Yes
action	add	Yes
service	Service ID	Yes
link	Link: 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
quantity	Quantity to order	Yes

उदाहरण अनुरोध:

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
}

आदेश स्थिति

एक ऑर्डर की स्थिति प्राप्त करें।

Parameter	Description
key	Your API key
action	status
order	Order 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"
}

संभावित स्थितियाँ:

PendingIn progressCompletedPartialCanceled

बैलेंस

अपना वर्तमान बैलेंस प्राप्त करें।

Parameter	Description
key	Your API key
action	balance

उदाहरण अनुरोध:

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

Parameter	Description
key	Your API key
action	sms_projects
country	Optional. 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

Parameter	Description	Required
project_id	Project ID from sms_projects	Yes
quantity	Number of numbers (1-10)	No (Default 1)
country	Country code (e.g. 'us')	No
phone	Phone number to reuse	No

{
  "orders": [
    {
      "order": 12345,
      "phone": "+1234567890",
      "country": "us",
      "status": "active"
    }
  ]
}

4. एसएमएस कोड प्राप्त करें

Action: sms_code

Parameter	Description
order	Order 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.com