कोई कार्य चुनें, पैरामीटर भरें और अनुरोध भेजें। लॉग इन होने पर, आपकी 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 के माध्यम से भेजे जाने चाहिए।
महत्वपूर्ण — उत्पाद छवि URL (imageUrl)
जब Media CDN सक्षम होता है, तो Services List, Products List, और Subcategory Info के रिस्पॉन्स में imageUrl फ़ील्ड CDN डोमेन (https://cdn.hstockplus.org/...) का उपयोग करते हैं। इन एब्सोल्यूट URL को सीधे अपने ऐप में इस्तेमाल करें — hstockplus.com या hstockplus.net को न बदलें।
https://cdn.hstockplus.org/uploads/products/gmail.webpवैकल्पिक। लक्ष्य भाषा कोड। नीचे सूचीबद्ध समर्थित कोडों में से एक का उपयोग करें। जब सेट किया जाए और en न हो, तो अनुवाद योग्य फ़ील्ड उस भाषा में लौटाए जाते हैं। यदि अभी तक अनुवाद उपलब्ध नहीं है, तो API अंग्रेज़ी लौटाता है।
समर्थित भाषा कोड
zhesfrdejakoptpt-BRruarhiviurbn-BDen(default — omit lang or use en)Please provide the text you want me to translate.
पढ़ने की कार्रवाइयों पर समर्थित: categories, subcategory_info, services, products, inventory ((उप-उत्पादों के नाम)), sms_projects, और sms_countries. हिंदी (hi) के लिए lang को हटाएँ या अंग्रेज़ी के लिए en का उपयोग करें।
सेवाओं/उत्पादों पर श्रेणी और उपश्रेणी फ़िल्टर पैरामीटर हमेशा विहित अंग्रेजी नामों का उपयोग करते हैं, भले ही भाषा सेट की गई हो।
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=services" \
-d "lang=zh"सभी श्रेणियाँ और प्रत्येक श्रेणी की उपश्रेणियाँ प्राप्त करें। सेवाओं की सूची को श्रेणी या उपश्रेणी के अनुसार फ़िल्टर करने के लिए इन मानों का उपयोग करें।
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | Yes |
| action | categories | Yes |
| lang | वैकल्पिक भाषा कोड। ऊपर दिए गए वैकल्पिक भाषा (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 द्वारा उपश्रेणी विवरण प्राप्त करें, जिसमें मूल श्रेणी शामिल हो। उत्पाद सूची पंक्तियों से subcategoryId का उपयोग करें।
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | Yes |
| action | subcategory_info | Yes |
| subcategoryId | Subcategory ID from Products List | Yes |
| lang | वैकल्पिक भाषा कोड। ऊपर दिए गए वैकल्पिक भाषा (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://cdn.hstockplus.org/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 सेवाएं नहीं)। सेवा सूची में उत्पाद पंक्तियों के समान फ़ील्ड, जिनमें id (उत्पाद इकाई आईडी), service (मैत्रीपूर्ण सेवा संख्या), description और imageUrl शामिल हैं। वैकल्पिक productIds केवल उन उत्पादों को लौटाता है (सूची से मैत्रीपूर्ण सेवा संख्याएं और/या उत्पाद इकाई आईडी, अल्पविराम से अलग या JSON सरणी, अधिकतम 100)। वैकल्पिक sort=sold परिणामों को भुगतान किए गए ऑर्डर इकाइयों के घटते क्रम में क्रमबद्ध करता है (पहले सबसे अधिक बिकने वाले)।
| 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 |
| sort | वैकल्पिक। sold = भुगतान किए गए ऑर्डर इकाइयों के घटते क्रम में क्रमबद्ध करें (पहले सबसे अधिक बिकने वाले)। डिफ़ॉल्ट कैश क्रम बनाए रखने के लिए इसे छोड़ दें। | No |
| lang | वैकल्पिक भाषा कोड। ऊपर दिए गए वैकल्पिक भाषा (lang) में समर्थित कोड देखें। | No |
curl -X POST https://hstockplus.com/api/v2 \
-d "key=YOUR_API_KEY" \
-d "action=products"उत्पाद आईडी द्वारा फ़िल्टर करें:
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 "subcategory=Twitter/X" \
-d "sort=sold" \
-d "page=1" \
-d "limit=10"केवल अनुशंसित उत्पाद:
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 केवल मेल खाने वाली पंक्तियाँ लौटाता है (उपयोगकर्ता-अनुकूल सेवा नंबर और/या एंटिटी आईडी; product या smm पंक्तियों से मेल खाता है)। केवल उत्पादों को फ़िल्टर करने के लिए action=products का उपयोग करें।
| 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 | वैकल्पिक फ़िल्टर: उत्पाद या एसएमएम। केवल मार्केटप्लेस उत्पाद या केवल एसएमएम सेवाएँ लौटाता है। | No |
| productIds | Optional list of IDs (friendly service numbers and/or entity ids). Comma-separated, JSON array, or repeated fields. Returns matching product or smm rows. Use action=products for products only. | No |
| lang | वैकल्पिक भाषा कोड। ऊपर दिए गए वैकल्पिक भाषा (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"इकाई प्रकार के अनुसार फ़िल्टर करें
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://cdn.hstockplus.org/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 कुल के बराबर होता है।
किसी सेवा की आईडी (सेवाओं की सूची में दी गई आईडी के अनुसार) के आधार पर उसका वर्तमान स्टॉक और उपलब्धता प्राप्त करें। मार्केटप्लेस उत्पादों के लिए, JSON में उप-उत्पाद शामिल होते हैं: सक्रिय वेरिएंट की एक सूची, जिनमें से प्रत्येक में subproductId, name, और stock (उस वेरिएंट के लिए प्रदर्शित स्टॉक) होता है।
| Parameter | Description | Required |
|---|---|---|
| key | Your API key | Yes |
| action | inventory | Yes |
| service | Service ID (from services list) | Yes |
| lang | वैकल्पिक भाषा कोड। ऊपर दिए गए वैकल्पिक भाषा (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 }
]
}प्रतिक्रिया में दर (प्रति इकाई, सेवाओं की सूची के समान स्ट्रिंग प्रारूप), entityType (smm या product), और autoDelivery (true = स्वचालित डिलीवरी, false = आपूर्तिकर्ता मैन्युअल रूप से पूरा करता है) शामिल है। उत्पाद सेवाओं के लिए, min और max सेवाओं की सूची में प्राथमिक उप-उत्पाद पंक्ति से मेल खाते हैं; यदि वह उप-उत्पाद आपके ऐड ऑर्डर को पूरा नहीं कर सकता है, तो प्लेटफ़ॉर्म कोई अन्य उप-उत्पाद चुन सकता है और उसकी इकाई मूल्य वसूल सकता है। subproducts ऐरे प्रदर्शन स्टॉक के साथ प्रत्येक सक्रिय वेरिएंट को सूचीबद्ध करता है; SMM इन्वेंट्री प्रतिक्रियाएँ उप-उत्पादों को छोड़ देती हैं।
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: यदि ऑर्डर स्वचालित रूप से पूरा होता है (जैसे SMM, ऑटो/इन्वेंट्री उत्पाद) तो true; यदि आपूर्तिकर्ता को मैन्युअल रूप से पूरा करना हो (इसमें कुछ समय लग सकता है) तो 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"
}
}
]जाँचें कि एक या अधिक ऑर्डर अभी रद्द किए जा सकते हैं या नहीं (रद्द करने के समान पात्रता नियम, लेकिन कोई रिफंड प्रोसेस नहीं होता)। cancel कॉल करने से पहले इसका उपयोग करें ताकि असफल अनुरोधों से बचा जा सके। बैच ऑर्डर आईडी (कॉमा से अलग, अधिकतम 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 | वैकल्पिक भाषा कोड। ऊपर दिए गए वैकल्पिक भाषा (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 | वैकल्पिक भाषा कोड। ऊपर दिए गए वैकल्पिक भाषा (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.com
