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

উপবিভাগ তথ্য

subcategoryId দ্বারা উপবিভাগের বিবরণ পান, মূল বিভাগ সহ। Products List সারি থেকে 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://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	ঐচ্ছিক। শুধুমাত্র isRecommended === true সহ পণ্য ফেরত দিতে 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"

শুধুমাত্র প্রস্তাবিত পণ্য:

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

প্রতিটি সারিতে id (এন্টিটি আইডি) এবং service (অর্ডারের জন্য বন্ধুত্বপূর্ণ পরিষেবা নম্বর), stock, entityType (smm বা product) এবং autoDelivery অন্তর্ভুক্ত থাকে। পণ্য সারিতে description, imageUrl, isRecommended এবং subcategoryIdও অন্তর্ভুক্ত থাকে। যখন limit 0 বা বাদ দেওয়া হয়, তখন সমস্ত পরিষেবা ফেরত দেওয়া হয় এবং page/limit মোটের সমান হয়।

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

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

বাতিল তৈরি করুন

এক বা একাধিক অর্ডার বাতিল করুন (PerfectPanel-সামঞ্জস্যপূর্ণ ব্যাচ ফরম্যাট)। প্রতিটি যোগ্য অর্ডারের টাকা আপনার ব্যালেন্সে ফেরত দেওয়া হবে।

নিচের সবগুলোই সত্য হতে হবে। রিফান্ড প্রক্রিয়া না করেই যোগ্যতা যাচাই করতে allowcancel ব্যবহার করুন।

প্রাথমিক বাতিল: প্ল্যাটফর্ম ফিচার সক্রিয় (অ্যাডমিন সেটিং)।
প্রাথমিক বাতিল: productType হলো অটো বা ইনভেন্টরি (SMM অটো সার্ভিস সাধারণত productType অটো ব্যবহার করে)।
প্রাথমিক বাতিল: পেমেন্টের অবস্থা সম্পূর্ণ বা আংশিক।
প্রাথমিক বাতিল: অর্ডারের অবস্থা পেন্ডিং, প্রক্রিয়াধীন বা ত্রুটিপূর্ণ (প্রোভাইডার ত্রুটিগুলি প্রক্রিয়াধীন হিসেবে দেখায়)।
প্রাথমিক বাতিল: কোনো external_id নেই (অর্ডারটি এখনও কোনো বাহ্যিক সরবরাহকারী বা প্রদানকারীর কাছে পাঠানো হয়নি)।
প্রাথমিক বাতিল: পেমেন্ট সম্পন্ন হওয়ার পর অন্তত N মিনিট (auto_order_early_refund_minutes, ডিফল্ট 30)।
প্রাথমিক বাতিল: গ্রাহক এই অর্ডারে আগে থেকেই প্রাথমিক স্ব-ফেরত ব্যবহার করেননি।
প্রাথমিক বাতিল: অর্ডার সম্পূর্ণ ডেলিভারি হয়নি (আংশিক ডেলিভারির ক্ষেত্রে অবিতরণকৃত অংশের জন্য আনুপাতিক ফেরত দেওয়া হয়)।
প্রাথমিক বাতিল: ফেরতযোগ্য পরিমাণ থাকবে (ফেরতযোগ্য পরিমাণ অর্ডার মোটের চেয়ে কম)।
প্রাথমিক বাতিল: অর্ডারে কোনো সক্রিয় বিরোধ নেই।
প্রাথমিক বাতিল: অনুরোধকৃত বা সম্পন্ন অবস্থায় কোনো সরবরাহকারী প্রত্যাহার নেই।

আংশিক ডেলিভারির ক্ষেত্রে আনুপাতিক হারে আংশিক ফেরত দেওয়া হয়; ডেলিভারি হওয়া অ্যাকাউন্টগুলো রাখা হয়।

Parameter	Description
key	Your API key
action	cancel
orders	অর্ডার আইডি (কমা দ্বারা পৃথক, সর্বোচ্চ ১০০টি আইডি)

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

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

বাতিলের অনুমতি দিন

এক বা একাধিক অর্ডার এখনই বাতিল করা যায় কিনা তা পরীক্ষা করুন (বাতিলের মতো একই যোগ্যতার নিয়ম, কিন্তু কোনো ফেরত প্রক্রিয়া করা হয় না)। ব্যর্থ অনুরোধ এড়াতে বাতিল কল করার আগে ব্যবহার করুন। ব্যাচ অর্ডার আইডি সমর্থন করে (কমা-বিচ্ছিন্ন, সর্বোচ্চ ১০০)।

প্রাথমিক বাতিল: প্ল্যাটফর্ম ফিচার সক্রিয় (অ্যাডমিন সেটিং)।
প্রাথমিক বাতিল: productType হলো অটো বা ইনভেন্টরি (SMM অটো সার্ভিস সাধারণত productType অটো ব্যবহার করে)।
প্রাথমিক বাতিল: পেমেন্টের অবস্থা সম্পূর্ণ বা আংশিক।
প্রাথমিক বাতিল: অর্ডারের অবস্থা পেন্ডিং, প্রক্রিয়াধীন বা ত্রুটিপূর্ণ (প্রোভাইডার ত্রুটিগুলি প্রক্রিয়াধীন হিসেবে দেখায়)।
প্রাথমিক বাতিল: কোনো external_id নেই (অর্ডারটি এখনও কোনো বাহ্যিক সরবরাহকারী বা প্রদানকারীর কাছে পাঠানো হয়নি)।
প্রাথমিক বাতিল: পেমেন্ট সম্পন্ন হওয়ার পর অন্তত N মিনিট (auto_order_early_refund_minutes, ডিফল্ট 30)।
প্রাথমিক বাতিল: গ্রাহক এই অর্ডারে আগে থেকেই প্রাথমিক স্ব-ফেরত ব্যবহার করেননি।
প্রাথমিক বাতিল: অর্ডার সম্পূর্ণ ডেলিভারি হয়নি (আংশিক ডেলিভারির ক্ষেত্রে অবিতরণকৃত অংশের জন্য আনুপাতিক ফেরত দেওয়া হয়)।
প্রাথমিক বাতিল: ফেরতযোগ্য পরিমাণ থাকবে (ফেরতযোগ্য পরিমাণ অর্ডার মোটের চেয়ে কম)।
প্রাথমিক বাতিল: অর্ডারে কোনো সক্রিয় বিরোধ নেই।
প্রাথমিক বাতিল: অনুরোধকৃত বা সম্পন্ন অবস্থায় কোনো সরবরাহকারী প্রত্যাহার নেই।

যখন allowcancel 1 হয়, তখন রেসপন্সে refundAmount (যে পরিমাণ ক্যান্সেল করলে ফেরত পাওয়া যাবে) অন্তর্ভুক্ত থাকে।

Parameter	Description
key	Your API key
action	allowcancel
orders	অর্ডার আইডি (কমা দ্বারা পৃথক, সর্বোচ্চ ১০০টি আইডি)

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

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

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)

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

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

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

উপবিভাগ তথ্য

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

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

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

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

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

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

পরিষেবা তালিকা

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

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

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

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

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

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

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

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

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

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

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

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

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

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

বাতিল তৈরি করুন

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

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

বাতিলের অনুমতি দিন

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

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

ব্যালেন্স

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

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

SMS Verification API

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

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

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

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

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

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

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