Customer API - HstockPlus

শুরু করুন

HstockPlus/API ডকুমেন্টেশন

API কী পেতে লগইন করুন

Your 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 প্যারামিটারের জন্য এই নির্দিষ্ট মানগুলি ব্যবহার করুন। Alias: jp কে ja হিসেবে গ্রহণ করা হয়।

পড়ার ক্রিয়াকলাপে সমর্থিত: categories, subcategory_info, services, products, inventory ((উপ-পণ্যের নামসমূহ)), sms_projects, এবং sms_countries. ইংরেজির জন্য lang বাদ দিন বা en ব্যবহার করুন।

সেবা/পণ্যের ক্ষেত্রে ক্যাটাগরি এবং সাবক্যাটাগরি ফিল্টার প্যারামিটার সর্বদা ইংরেজি ক্যানোনিকাল নাম ব্যবহার করে, এমনকি যখন lang সেট করা থাকে।

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

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	ঐচ্ছিক ভাষা কোড। উপরে উল্লিখিত ঐচ্ছিক ভাষা (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	ঐচ্ছিক ভাষা কোড। উপরে উল্লিখিত ঐচ্ছিক ভাষা (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"

Services List

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	ঐচ্ছিক ভাষা কোড। উপরে উল্লিখিত ঐচ্ছিক ভাষা (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://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.

ইনভেন্টরি পরীক্ষা করুন

একটি পরিষেবার জন্য তার আইডি দ্বারা বর্তমান স্টক এবং প্রাপ্যতা পান (পরিষেবা তালিকার মতো একই আইডি)। মার্কেটপ্লেস পণ্যের জন্য, JSON-এ subproducts অন্তর্ভুক্ত থাকে: সক্রিয় ভেরিয়েন্টের একটি অ্যারে, প্রতিটিতে 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"

উদাহরণ প্রতিক্রিয়া (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 = সরবরাহকারী ম্যানুয়ালি পূরণ করে) অন্তর্ভুক্ত থাকে। পণ্য পরিষেবার জন্য, min এবং max পরিষেবা তালিকার প্রাথমিক সাবপ্রোডাক্ট সারির সাথে মেলে; যদি সেই সাবপ্রোডাক্ট আপনার অর্ডার যোগ করতে না পারে, তাহলে প্ল্যাটফর্ম অন্য একটি সাবপ্রোডাক্ট নির্বাচন করতে পারে এবং তার ইউনিট মূল্য চার্জ করতে পারে। 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
}

প্রোডাক্ট অর্ডারের জন্য (যেমন অ্যাকাউন্ট), যখন অর্ডার সম্পূর্ণ বা আংশিকভাবে ডেলিভারি করা হয়, তখন প্রতিক্রিয়ায় ডেলিভারি করা অ্যাকাউন্টের ক্রেডেনশিয়াল (প্রতি অ্যাকাউন্টে একটি স্ট্রিং) সহ একটি "accounts" অ্যারে অন্তর্ভুক্ত থাকে। আংশিক ডেলিভারির জন্য, শুধুমাত্র এখন পর্যন্ত ডেলিভারি করা অ্যাকাউন্টগুলি ফেরত দেওয়া হয়।

autoDelivery: সত্য যদি অর্ডার স্বয়ংক্রিয়ভাবে পূর্ণ হয় (যেমন SMM, স্বয়ংক্রিয়/ইনভেন্টরি পণ্য); মিথ্যা যদি সরবরাহকারীকে ম্যানুয়ালি পূর্ণ করতে হয় (কিছু সময় লাগতে পারে)।

উদাহরণ প্রতিক্রিয়া (ডেলিভারি করা অ্যাকাউন্ট সহ প্রোডাক্ট অর্ডার):

{
  "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. এসএমএস প্রকল্প পান

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

2. এসএমএস দেশ পান

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

3. SMS অর্ডার তৈরি করুন

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. এসএমএস অর্ডার অবস্থা পান

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

Your API Key

টেস্ট API

API এন্ডপয়েন্ট

ঐচ্ছিক ভাষা (lang)

বিভাগসমূহ পান

উদাহরণ অনুরোধ:

উদাহরণ প্রতিক্রিয়া:

Subcategory Info

উদাহরণ অনুরোধ:

উদাহরণ প্রতিক্রিয়া:

দোকানের তালিকা

উদাহরণ অনুরোধ:

পণ্যের তালিকা

উদাহরণ অনুরোধ:

Services List

উদাহরণ অনুরোধ:

উদাহরণ প্রতিক্রিয়া:

ইনভেন্টরি পরীক্ষা করুন

উদাহরণ অনুরোধ:

উদাহরণ প্রতিক্রিয়া (SMM):

উদাহরণ প্রতিক্রিয়া (পণ্য):

অর্ডার যোগ করুন

উদাহরণ অনুরোধ:

উদাহরণ প্রতিক্রিয়া:

অর্ডার স্ট্যাটাস

উদাহরণ অনুরোধ:

উদাহরণ প্রতিক্রিয়া:

উদাহরণ প্রতিক্রিয়া (ডেলিভারি করা অ্যাকাউন্ট সহ প্রোডাক্ট অর্ডার):

সম্ভাব্য স্ট্যাটাস:

ব্যালেন্স

উদাহরণ অনুরোধ:

উদাহরণ প্রতিক্রিয়া:

SMS Verification API

1. এসএমএস প্রকল্প পান

2. এসএমএস দেশ পান

3. SMS অর্ডার তৈরি করুন

4. এসএমএস কোড পান

5. এসএমএস অর্ডার অবস্থা পান

ত্রুটি প্রতিক্রিয়া

সমর্থিত পেমেন্ট পদ্ধতি