آپ کی API Key
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.
| 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,
"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.
انوینٹری چیک کریں
ایک سروس کے لیے اس کی آئی ڈی کے ذریعے موجودہ اسٹاک اور دستیابی حاصل کریں (سروسز کی فہرست میں اسی آئی ڈی کے مطابق)۔
| 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,
"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.
| 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",
"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"
]
}ممکنہ حیثیتیں:
بقیہ
اپنا موجودہ بیلنس حاصل کریں۔
| 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.net
Supported payment methods
