Customer API - HstockPlus

شروع کریں

HstockPlus/API دستاویزات

API کلید حاصل کرنے کے لیے لاگ ان کریں

آپ کی API Key

لوڈ ہو رہا ہے...

Test API

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

API Key

عمل

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. SMS پروجیکٹس حاصل کریں

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. SMS ممالک حاصل کریں

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