ایک کارروائی منتخب کریں، پیرامیٹرز بھریں، اور درخواست بھیجیں۔ لاگ ان ہونے پر، آپ کی API کلید خود بخود لوڈ ہو جاتی ہے۔
جب آپ عمل یا پیرامیٹرز تبدیل کرتے ہیں تو خود بخود اپ ڈیٹ ہو جاتا ہے۔
curl -X POST "https://hstockplus.com/api/v2" \
--data-urlencode "key=YOUR_API_KEY" \
--data-urlencode "action=categories"https://hstockplus.com/api/v2تمام API درخواستیں اس اینڈ پوائنٹ پر HTTP POST کے ذریعے بھیجی جانی چاہئیں۔
اختیاری۔ ہدف زبان کا کوڈ۔ نیچے دیے گئے معاون کوڈز میں سے ایک استعمال کریں۔ جب سیٹ ہو اور en نہ ہو، تو قابل ترجمہ فیلڈز اس زبان میں واپس کیے جاتے ہیں۔ اگر ترجمہ ابھی دستیاب نہیں ہے، تو API انگریزی واپس کرتا ہے۔
معاون زبان کے کوڈز
zhesfrdejakoptpt-BRruarhiviurbn-BDen(پہلے سے طے شدہ — lang کو چھوڑ دیں یا en استعمال کریں)lang پیرامیٹر کے لیے یہ عین اقدار استعمال کریں۔ عرف: jp کو ja کے طور پر قبول کیا جاتا ہے۔
پڑھنے کی کارروائیوں پر معاون: categories, subcategory_info, services, products, inventory ((ذیلی مصنوعات کے نام)), sms_projects, اور sms_countries. انگریزی کے لیے lang کو چھوڑ دیں یا en استعمال کریں۔
خدمات/مصنوعات پر category اور subcategory فلٹر پیرامیٹرز ہمیشہ کینونیکل انگریزی نام استعمال کرتے ہیں، چاہے lang سیٹ ہو۔
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=services" \
-d "lang=zh"تمام زمرے اور ہر زمرے کے ذیلی زمرے حاصل کریں۔ Services List کو زمرے یا ذیلی زمرے کے مطابق فلٹر کرنے کے لیے ان اقدار کا استعمال کریں۔
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | Yes |
| action | categories | Yes |
| lang | اختیاری زبان کا کوڈ۔ اوپر Optional language (lang) میں معاون کوڈز دیکھیں۔ | No |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=categories" \
-d "lang=zh"{
"categories": [
{
"category": "Instagram",
"subcategories": ["Followers", "Comments", "Likes"]
},
{
"category": "Email Accounts",
"subcategories": ["Gmail", "Outlook"]
}
]
}subcategoryId کے ذریعے ذیلی زمرے کی تفصیلات حاصل کریں، بشمول والدین کا زمرہ۔ Products List کی قطاروں سے subcategoryId استعمال کریں۔
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | Yes |
| action | subcategory_info | Yes |
| subcategoryId | Subcategory ID from Products List | Yes |
| lang | اختیاری زبان کا کوڈ۔ اوپر Optional language (lang) میں معاون کوڈز دیکھیں۔ | No |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=subcategory_info" \
-d "subcategoryId=674a1f77bcf86cd799439099" \
-d "lang=zh"{
"subcategoryId": "674a1f77bcf86cd799439099",
"name": "Gmail",
"slug": "gmail",
"imageUrl": "https://example.com/uploads/subcategories/gmail.webp",
"description": "Verified Gmail accounts",
"category": {
"categoryId": "674a1f77bcf86cd799439088",
"name": "Email Accounts",
"slug": "email-accounts"
}
}فعال دکانوں کی فہرست بنائیں جن میں بنیادی معلومات، مصنوعات کی تعداد اور جائزے کی درجہ بندی شامل ہو۔ پرائیویسی کے لیے دکانوں کے نام چھپائے گئے ہیں۔
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | Yes |
| action | shops | Yes |
| page | Page number (default 1). | No |
| limit | Items per page (default 20). | No |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=shops"پیجینیشن کے ساتھ:
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=shops" \
-d "page=1" \
-d "limit=20"صرف مارکیٹ پلیس مصنوعات کی فہرست بنائیں (SMM خدمات نہیں)۔ Services List میں مصنوعات کی قطاروں جیسے ہی فیلڈز، بشمول id (مصنوعات کی ہستی کی شناخت)، service (دوستانہ سروس نمبر)، description اور imageUrl۔ اختیاری productIds صرف وہ مصنوعات لوٹاتا ہے (فہرست سے دوستانہ سروس نمبر اور/یا مصنوعات کی ہستی کی شناخت، کوما سے الگ یا JSON صف، زیادہ سے زیادہ 100)۔
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | Yes |
| action | products | 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 products in this category. | No |
| subcategory | Filter by subcategory name (from Get Categories). Returns only products in this subcategory. | No |
| shopId | Filter by shop ID (from Shops List). Returns only that shop's products. | No |
| productIds | Optional list of product IDs (service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns only those products (max 100). | No |
| isRecommended | اختیاری۔ صرف ان مصنوعات کو لوٹانے کے لیے true سیٹ کریں جن کے لیے isRecommended === true ہے۔ | No |
| lang | اختیاری زبان کا کوڈ۔ اوپر Optional language (lang) میں معاون کوڈز دیکھیں۔ | No |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=products"product IDs کے مطابق فلٹر کریں:
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=products" \
-d "productIds=2,5,9"پیجینیشن کے ساتھ:
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=products" \
-d "page=1" \
-d "limit=50"زمرے یا ذیلی زمرے کے مطابق فلٹر کریں:
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=products" \
-d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=products" \
-d "subcategory=Gmail"صرف تجویز کردہ مصنوعات:
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=products" \
-d "isRecommended=true"تمام دستیاب خدمات کو اختیاری صفحہ بندی کے ساتھ حاصل کریں۔ ہر قطار میں id (ہستی کی شناخت)، service (دوستانہ سروس نمبر)، stock، اور entityType (smm یا product) شامل ہیں۔ اختیاری entityType صرف product یا صرف smm کی قطاریں لوٹاتا ہے۔ اختیاری category اور subcategory پیرامیٹرز صرف اس زمرے یا ذیلی زمرے کی خدمات لوٹاتے ہیں (Get Categories API سے اقدار)۔ اختیاری shopId صرف اس دکان کی مصنوعات اور خدمات لوٹاتا ہے (Shops List سے shopId استعمال کریں)۔ اختیاری productIds صرف مماثل مارکیٹ پلیس مصنوعات لوٹاتا ہے (جب productIds سیٹ کیا جائے تو SMM خدمات کو چھوڑ دیا جاتا ہے)۔
| 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 |
| shopId | Filter by shop ID (from Shops List). Returns only that shop's products and SMM services. | No |
| entityType | اختیاری فلٹر: product یا smm۔ صرف مارکیٹ پلیس مصنوعات یا صرف SMM خدمات واپس کرتا ہے۔ | No |
| productIds | Optional list of product IDs (service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns only those products; SMM rows are omitted. | No |
| lang | اختیاری زبان کا کوڈ۔ اوپر Optional language (lang) میں معاون کوڈز دیکھیں۔ | No |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=services" \
-d "lang=zh"پیجینیشن کے ساتھ:
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=services" \
-d "page=1" \
-d "limit=50"زمرے یا ذیلی زمرے کے مطابق فلٹر کریں:
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"entityType کے مطابق فلٹر کریں:
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=services" \
-d "entityType=product"{
"services": [
{
"id": "507f1f77bcf86cd799439011",
"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
},
{
"id": "507f1f77bcf86cd799439012",
"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,
"description": "Verified Gmail account with recovery email",
"imageUrl": "https://example.com/uploads/products/gmail.webp",
"isRecommended": true,
"subcategoryId": "674a1f77bcf86cd799439099"
}
],
"total": 150,
"page": 1,
"limit": 50,
"total_pages": 3
}ہر قطار میں id (ہستی کی شناخت) اور service (آرڈرز کے لیے دوستانہ سروس نمبر)، stock، entityType (smm یا product)، اور autoDelivery شامل ہیں۔ مصنوعات کی قطاروں میں description، imageUrl، isRecommended، اور subcategoryId بھی شامل ہیں۔ جب limit 0 ہو یا چھوڑ دی جائے، تمام خدمات لوٹائی جاتی ہیں اور page/limit کل کے برابر ہوتے ہیں۔
کسی سروس کے لیے اس کے ID (وہی ID جو خدمات کی فہرست میں ہے) کے ذریعے موجودہ اسٹاک اور دستیابی حاصل کریں۔ مارکیٹ پلیس مصنوعات کے لیے، JSON میں subproducts شامل ہیں: فعال ویریئنٹس کی ایک صف، ہر ایک میں subproductId، name، اور stock (اس ویریئنٹ کے لیے ڈسپلے اسٹاک)۔
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | Yes |
| action | inventory | Yes |
| service | Service ID (from services list) | Yes |
| lang | اختیاری زبان کا کوڈ۔ اوپر Optional language (lang) میں معاون کوڈز دیکھیں۔ | No |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=inventory" \
-d "service=23501"{
"service": 1,
"stock": 10000,
"available": true,
"rate": "0.5000",
"entityType": "smm",
"autoDelivery": true
}{
"service": 23501,
"stock": 42,
"available": true,
"rate": "25.0000",
"min": 1,
"max": 42,
"entityType": "product",
"autoDelivery": true,
"subproducts": [
{ "subproductId": "674a1f77bcf86cd799439011", "name": "1 Month", "stock": 42 },
{ "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0 }
]
}جواب میں rate (فی یونٹ، خدمات کی فہرست جیسی سٹرنگ فارمیٹ)، entityType (smm یا product)، اور autoDelivery (true = خودکار ڈیلیوری، false = سپلائر دستی طور پر پورا کرتا ہے) شامل ہے۔ product خدمات کے لیے، min اور max خدمات کی فہرست میں بنیادی subproduct قطار سے مماثل ہوتے ہیں؛ اگر وہ subproduct آپ کا آرڈر پورا نہیں کر سکتا، تو پلیٹ فارم دوسرا subproduct منتخب کر سکتا ہے اور اس کی یونٹ قیمت وصول کر سکتا ہے۔ subproducts صف ہر فعال ویریئنٹ کو ڈسپلے اسٹاک کے ساتھ درج کرتی ہے؛ SMM انوینٹری کے جوابات subproducts کو خارج کرتے ہیں۔
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 اگر آرڈر خود بخود پورا ہو جاتا ہے (مثلاً SMM، آٹو/انوینٹری مصنوعات)؛ false اگر سپلائر کو دستی طور پر پورا کرنا ہو (کچھ وقت لگ سکتا ہے)۔
{
"status": "Completed",
"charge": "10.00",
"start_count": 5,
"remains": 0,
"currency": "USD",
"entityType": "product",
"autoDelivery": true,
"accounts": [
"user1:pass1",
"user2:pass2"
]
}ایک یا ایک سے زیادہ آرڈرز منسوخ کریں (PerfectPanel-مطابق بیچ فارمیٹ)۔ ہر اہل آرڈر کی رقم آپ کے بیلنس میں واپس کر دی جائے گی۔
مندرجہ ذیل تمام شرائط درست ہونی چاہئیں۔ رقم واپسی پر کارروائی کیے بغیر اہلیت جانچنے کے لیے allowcancel استعمال کریں۔
جزوی فراہمی پر متناسب جزوی رقم واپس کی جاتی ہے؛ فراہم کردہ اکاؤنٹس برقرار رہتے ہیں۔
| Parameter | Description |
|---|---|
| key | Your API key |
| action | cancel |
| orders | آرڈر آئی ڈیز (کوما سے الگ، زیادہ سے زیادہ 100 آئی ڈیز) |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=cancel" \
-d "orders=23501,23502"[
{
"order": 23501,
"cancel": 1
},
{
"order": 23502,
"cancel": {
"error": "Incorrect order ID"
}
}
]چیک کریں کہ آیا ایک یا زیادہ آرڈرز ابھی منسوخ کیے جا سکتے ہیں (منسوخی کے وہی اہلیت کے قواعد، لیکن کوئی رقم واپس نہیں کی جاتی)۔ منسوخ کرنے سے پہلے استعمال کریں تاکہ ناکام درخواستوں سے بچا جا سکے۔ بیچ آرڈر آئی ڈیز کو سپورٹ کرتا ہے (کوما سے الگ، زیادہ سے زیادہ 100)۔
مندرجہ ذیل تمام شرائط درست ہونی چاہئیں۔ رقم واپسی پر کارروائی کیے بغیر اہلیت جانچنے کے لیے allowcancel استعمال کریں۔
جب allowcancel 1 ہو، تو جواب میں refundAmount شامل ہوتا ہے (وہ رقم جو منسوخی واپس کرے گی)۔
| Parameter | Description |
|---|---|
| key | Your API key |
| action | allowcancel |
| orders | آرڈر آئی ڈیز (کوما سے الگ، زیادہ سے زیادہ 100 آئی ڈیز) |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=allowcancel" \
-d "orders=23501,23502"[
{
"order": 23501,
"allowcancel": 1,
"refundAmount": 5.00
},
{
"order": 23502,
"allowcancel": 0,
"error": "Early auto refund is not available for this order",
"reason": "BEFORE_MIN_WAIT",
"eligibleAfter": "2026-06-23T12:30:00.000Z"
}
]اپنا موجودہ بیلنس حاصل کریں۔
| 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"
}ایس ایم ایس تصدیقی خدمات کے لیے مخصوص اختتامی نقاط۔
Action: sms_projects
| Parameter | Description |
|---|---|
| key | Your API key |
| action | sms_projects |
| country | Optional. Filter by country ID (e.g. 'us', 'gb') |
| lang | اختیاری زبان کا کوڈ۔ اوپر Optional language (lang) میں معاون کوڈز دیکھیں۔ |
[
{
"project_id": "65f...",
"name": "OpenAI / ChatGPT",
"price": "0.5000",
"country_id": "us",
"country_title": "United States"
}
]Action: sms_countries
| Parameter | Description |
|---|---|
| key | Your API key |
| action | sms_countries |
| lang | اختیاری زبان کا کوڈ۔ اوپر Optional language (lang) میں معاون کوڈز دیکھیں۔ |
[
{
"country_code": "us",
"country_name": "United States"
},
{
"country_code": "gb",
"country_name": "United Kingdom"
}
]Action: add_sms
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | |
| action | add_sms | |
| 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"
}
]
}Action: sms_code
| Parameter | Description |
|---|---|
| key | Your API key |
| action | sms_code |
| order | Order ID |
{
"status": "completed",
"code": "123456",
"sms_content": "Your verification code is 123456"
}
// OR
{
"status": "waiting",
"message": "Waiting for code"
}Action: sms_status
| Parameter | Description |
|---|---|
| key | Your API key |
| action | sms_status |
| order | Order ID |
{
"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
