Customer API - HstockPlus

شروع کریں

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

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

آپ کی API Key

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

API کی جانچ کریں

ایک کارروائی منتخب کریں، پیرامیٹرز بھریں، اور درخواست بھیجیں۔ لاگ ان ہونے پر، آپ کی API کلید خود بخود لوڈ ہو جاتی ہے۔

API کلید

زبان (اختیاری)

عمل

درخواست کا حکم

جب آپ عمل یا پیرامیٹرز تبدیل کرتے ہیں تو خود بخود اپ ڈیٹ ہو جاتا ہے۔

curl -X POST "https://hstockplus.com/api/v2" \
  --data-urlencode "key=YOUR_API_KEY" \
  --data-urlencode "action=categories"

API اینڈ پوائنٹ

https://hstockplus.com/api/v2

تمام API درخواستیں اس اینڈ پوائنٹ پر HTTP POST کے ذریعے بھیجی جانی چاہئیں۔

اختیاری زبان (lang)

اختیاری۔ ہدف زبان کا کوڈ۔ نیچے دیے گئے معاون کوڈز میں سے ایک استعمال کریں۔ جب سیٹ ہو اور 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"]
    }
  ]
}

Subcategory Info

Get subcategory details by subcategoryId, including the parent category. Use subcategoryId from Products List rows.

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"

مصنوعات کی فہرست

List marketplace products only (no SMM services). Same fields as product rows in Services List, including id (product entity id), service (friendly service number), description and imageUrl. Optional productIds returns only those products (friendly service numbers from the list and/or product entity ids, comma-separated or JSON array, max 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	Optional. Set true to return only products with 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"

خدمات کی فہرست

Get all available services with optional pagination. Each row includes id (entity id), service (friendly service number), stock, and entityType (smm or product). Optional entityType returns only product or only smm rows. Optional category and subcategory parameters return only services in that category or subcategory (values from the Get Categories API). Optional shopId returns only products and services for that shop (use shopId from Shops List). Optional productIds returns only matching marketplace products (SMM services are omitted when productIds is set).

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
}

Each row includes id (entity id) and service (friendly service number for orders), stock, entityType (smm or product), and autoDelivery. Product rows also include description, imageUrl, isRecommended, and subcategoryId. When limit is 0 or omitted, all services are returned and page/limit equal total.

انوینٹری چیک کریں

کسی سروس کے لیے اس کے 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"

مثال کے جواب (SMM):

{
  "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"
  ]
}

ممکنہ حیثیتیں:

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')
lang	اختیاری زبان کا کوڈ۔ اوپر Optional language (lang) میں معاون کوڈز دیکھیں۔

[
  {
    "project_id": "65f...",
    "name": "OpenAI / ChatGPT",
    "price": "0.5000",
    "country_id": "us",
    "country_title": "United States"
  }
]

2. SMS ممالک حاصل کریں

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"
  }
]

3. ایس ایم ایس آرڈر بنائیں

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"
    }
  ]
}

4. ایس ایم ایس کوڈ حاصل کریں

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"
}

5. SMS آرڈر کی حیثیت حاصل کریں

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

آپ کی API Key

API کی جانچ کریں

API اینڈ پوائنٹ

اختیاری زبان (lang)

زمرے حاصل کریں

مثال درخواست:

مثال جواب:

Subcategory Info

مثال درخواست:

مثال جواب:

دکانوں کی فہرست

مثال درخواست:

مصنوعات کی فہرست

مثال درخواست:

خدمات کی فہرست

مثال درخواست:

مثال جواب:

انوینٹری چیک کریں

مثال درخواست:

مثال کے جواب (SMM):

مثال کے طور پر جواب (مصنوعہ)

آرڈر شامل کریں

مثال درخواست:

مثال جواب:

آرڈر کی حیثیت

مثال درخواست:

مثال جواب:

مثال کا جواب (پروڈکٹ آرڈر جس میں اکاؤنٹس ڈیلیور ہوئے ہوں):

ممکنہ حیثیتیں:

بقیہ

مثال درخواست:

مثال جواب:

SMS Verification API

1. SMS پروجیکٹس حاصل کریں

2. SMS ممالک حاصل کریں

3. ایس ایم ایس آرڈر بنائیں

4. ایس ایم ایس کوڈ حاصل کریں

5. SMS آرڈر کی حیثیت حاصل کریں

خرابی کے جوابات

مددگار ادائیگی کے طریقے