HstockPlus

HstockPlus/توثيق API

مفتاح API الخاص بك

جاري التحميل...

اختبار 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 إلى نقطة النهاية هذه.

هام — روابط صور المنتج (imageUrl)

عند تفعيل Media CDN، تستخدم حقول imageUrl في استجابات قائمة الخدمات وقائمة المنتجات ومعلومات الفئة الفرعية نطاق CDN (https://cdn.hstockplus.org/...). استخدم هذه الروابط المطلقة مباشرة في تطبيقك — لا تستبدلها بـ hstockplus.com أو hstockplus.net.

https://cdn.hstockplus.org/uploads/products/gmail.webp

اختياري (lang)

اختياري. رمز اللغة الهدف. استخدم أحد الرموز المدعومة المدرجة أدناه. عند تعيينه وعدم كونه "en"، يتم إرجاع الحقول القابلة للترجمة بتلك اللغة. إذا لم تكن الترجمة متاحة بعد، تقوم واجهة API بإرجاع النص باللغة الإنجليزية.

رموز اللغات المدعومة

zhesfrdejakoptpt-BRruarhiviurbn-BDen(افتراضي — احذف اللغة أو استخدم en)

Use these exact values for the lang parameter. Alias: jp is accepted as ja.

مدعوم في عمليات القراءة: categories, subcategory_info, services, products, inventory ((أسماء المنتجات الفرعية)), sms_projects, و sms_countries. احذف 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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.	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"]
    }
  ]
}

معلومات الفئة الفرعية

احصل على تفاصيل الفئة الفرعية باستخدام معرف الفئة الفرعية، بما في ذلك الفئة الرئيسية. استخدم معرف الفئة الفرعية من صفوف قائمة المنتجات.

Parameter	Description	Required
key	Your API key	Yes
action	subcategory_info	Yes
subcategoryId	Subcategory ID from Products List	Yes
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"

قائمة المنتجات

قائمة منتجات السوق فقط (بدون خدمات وسائل التواصل الاجتماعي). نفس حقول صفوف المنتجات في قائمة الخدمات، بما في ذلك 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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.	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 يُرجع إما صفوف المنتجات فقط أو صفوف smm فقط. المعاملات الاختيارية category وsubcategory تُرجع فقط الخدمات الموجودة في تلك الفئة أو الفئة الفرعية (القيم من واجهة الحصول على الفئات). المعامل الاختياري shopId يُرجع فقط المنتجات والخدمات الخاصة بهذا المتجر (استخدم shopId من قائمة المتاجر). المعامل الاختياري productIds يُرجع فقط الصفوف المطابقة (أرقام الخدمات المختصرة و/أو معرفات الكيان؛ يطابق صفوف المنتجات أو 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	عامل تصفية اختياري: product أو smm. يُرجع منتجات السوق فقط أو خدمات SMM فقط.	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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.	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
}

يحتوي كل صف على المعرف (معرف الكيان) والخدمة (رقم الخدمة الميسر للطلبات)، والمخزون، ونوع الكيان (smm أو منتج)، والتوصيل التلقائي. تتضمن صفوف المنتجات أيضًا الوصف، رابط الصورة، هل هو موصى به، ومعرف الفئة الفرعية. عندما يكون الحد 0 أو محذوفًا، يتم إرجاع جميع الخدمات وتكون الصفحة/الحد مساويًا للإجمالي.

فحص المخزون

احصل على المخزون الحالي والتوفر لخدمة ما باستخدام معرفها (نفس المعرف الموجود في قائمة الخدمات). بالنسبة لمنتجات السوق، يتضمن ملف JSON منتجات فرعية: مصفوفة من المتغيرات النشطة، كل منها يحتوي على معرف المنتج الفرعي، الاسم، والمخزون (المخزون المعروض لذلك المتغير).

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service ID (from services list)	Yes
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 }
  ]
}

يحتوي الرد على السعر (لكل وحدة، بنفس تنسيق السلسلة النصية لقائمة الخدمات)، ونوع الكيان (smm أو product)، والتوصيل التلقائي (true = توصيل تلقائي، false = المورد ينفذ يدويًا). بالنسبة لخدمات المنتجات، يتطابق الحد الأدنى والحد الأقصى مع صف المنتج الفرعي الرئيسي في قائمة الخدمات؛ إذا لم يتمكن هذا المنتج الفرعي من تنفيذ طلب الإضافة الخاص بك، فقد تختار المنصة منتجًا فرعيًا آخر وتفرض سعر وحدته. تحتوي مصفوفة المنتجات الفرعية على قائمة بكل متغير نشط مع المخزون المعروض؛ تستجيب مخزونات 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
}

لطلبات المنتجات (مثل الحسابات)، عندما يتم تسليم الطلب كليًا أو جزئيًا، تتضمن الاستجابة مصفوفة "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 هو auto أو inventory (خدمات SMM التلقائية عادةً ما تستخدم productType auto).
الإلغاء المبكر: حالة الدفع مكتملة أو جزئية.
الإلغاء المبكر: حالة الطلب معلقة، قيد المعالجة، أو خطأ (تظهر أخطاء المزود كأنها قيد التقدم).
إلغاء مبكر: لا يوجد معرف خارجي (الطلب لم يُرسل بعد إلى مورد أو مزود خارجي).
الإلغاء المبكر: على الأقل N دقيقة من وقت إتمام الدفع (auto_order_early_refund_minutes، القيمة الافتراضية 30).
الإلغاء المبكر: لم يستخدم العميل خيار الاسترداد الذاتي المبكر لهذا الطلب من قبل.
الإلغاء المبكر: لم يتم تسليم الطلب بالكامل (التسليم الجزئي يؤدي إلى استرداد نسبي للجزء غير المُسلَّم).
الإلغاء المبكر: المبلغ القابل للاسترداد لا يزال متاحًا (المبلغ المسترد أقل من إجمالي الطلب).
الإلغاء المبكر: لا يوجد نزاع نشط على الطلب.
الإلغاء المبكر: لا يوجد سحب من المورد في الحالة المطلوبة أو المكتملة.

التسليم الجزئي يؤدي إلى استرداد جزئي نسبي؛ ويتم الاحتفاظ بالحسابات التي تم تسليمها.

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" للتحقق من الأهلية دون معالجة استرداد.

الإلغاء المبكر: تم تفعيل ميزة المنصة (إعدادات المسؤول).
الإلغاء المبكر: productType هو auto أو inventory (خدمات SMM التلقائية عادةً ما تستخدم productType auto).
الإلغاء المبكر: حالة الدفع مكتملة أو جزئية.
الإلغاء المبكر: حالة الطلب معلقة، قيد المعالجة، أو خطأ (تظهر أخطاء المزود كأنها قيد التقدم).
إلغاء مبكر: لا يوجد معرف خارجي (الطلب لم يُرسل بعد إلى مورد أو مزود خارجي).
الإلغاء المبكر: على الأقل N دقيقة من وقت إتمام الدفع (auto_order_early_refund_minutes، القيمة الافتراضية 30).
الإلغاء المبكر: لم يستخدم العميل خيار الاسترداد الذاتي المبكر لهذا الطلب من قبل.
الإلغاء المبكر: لم يتم تسليم الطلب بالكامل (التسليم الجزئي يؤدي إلى استرداد نسبي للجزء غير المُسلَّم).
الإلغاء المبكر: المبلغ القابل للاسترداد لا يزال متاحًا (المبلغ المسترد أقل من إجمالي الطلب).
الإلغاء المبكر: لا يوجد نزاع نشط على الطلب.
الإلغاء المبكر: لا يوجد سحب من المورد في الحالة المطلوبة أو المكتملة.

عندما تكون قيمة 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"
}

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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.

[
  {
    "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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.

[
  {
    "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. الحصول على حالة طلب الرسائل القصيرة

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

ابدأ

HstockPlus/توثيق API

تسجيل الدخول للحصول على مفتاح API

مفتاح 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 إلى نقطة النهاية هذه.

هام — روابط صور المنتج (imageUrl)

https://cdn.hstockplus.org/uploads/products/gmail.webp

اختياري (lang)

رموز اللغات المدعومة

zhesfrdejakoptpt-BRruarhiviurbn-BDen(افتراضي — احذف اللغة أو استخدم en)

Use these exact values for the lang parameter. Alias: jp is accepted as ja.

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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.	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"]
    }
  ]
}

معلومات الفئة الفرعية

Parameter	Description	Required
key	Your API key	Yes
action	subcategory_info	Yes
subcategoryId	Subcategory ID from Products List	Yes
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"

قائمة المنتجات

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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.	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"

قائمة الخدمات

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 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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.	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
}

فحص المخزون

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service ID (from services list)	Yes
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 }
  ]
}

إضافة طلب

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
}

مثال على الاستجابة (طلب منتج مع تسليم الحسابات):

{
  "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 هو auto أو inventory (خدمات SMM التلقائية عادةً ما تستخدم productType auto).
الإلغاء المبكر: حالة الدفع مكتملة أو جزئية.
الإلغاء المبكر: حالة الطلب معلقة، قيد المعالجة، أو خطأ (تظهر أخطاء المزود كأنها قيد التقدم).
إلغاء مبكر: لا يوجد معرف خارجي (الطلب لم يُرسل بعد إلى مورد أو مزود خارجي).
الإلغاء المبكر: على الأقل N دقيقة من وقت إتمام الدفع (auto_order_early_refund_minutes، القيمة الافتراضية 30).
الإلغاء المبكر: لم يستخدم العميل خيار الاسترداد الذاتي المبكر لهذا الطلب من قبل.
الإلغاء المبكر: لم يتم تسليم الطلب بالكامل (التسليم الجزئي يؤدي إلى استرداد نسبي للجزء غير المُسلَّم).
الإلغاء المبكر: المبلغ القابل للاسترداد لا يزال متاحًا (المبلغ المسترد أقل من إجمالي الطلب).
الإلغاء المبكر: لا يوجد نزاع نشط على الطلب.
الإلغاء المبكر: لا يوجد سحب من المورد في الحالة المطلوبة أو المكتملة.

التسليم الجزئي يؤدي إلى استرداد جزئي نسبي؛ ويتم الاحتفاظ بالحسابات التي تم تسليمها.

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

السماح بالإلغاء

يجب أن يكون كل ما يلي صحيحًا. استخدم "allowcancel" للتحقق من الأهلية دون معالجة استرداد.

الإلغاء المبكر: تم تفعيل ميزة المنصة (إعدادات المسؤول).
الإلغاء المبكر: productType هو auto أو inventory (خدمات SMM التلقائية عادةً ما تستخدم productType auto).
الإلغاء المبكر: حالة الدفع مكتملة أو جزئية.
الإلغاء المبكر: حالة الطلب معلقة، قيد المعالجة، أو خطأ (تظهر أخطاء المزود كأنها قيد التقدم).
إلغاء مبكر: لا يوجد معرف خارجي (الطلب لم يُرسل بعد إلى مورد أو مزود خارجي).
الإلغاء المبكر: على الأقل N دقيقة من وقت إتمام الدفع (auto_order_early_refund_minutes، القيمة الافتراضية 30).
الإلغاء المبكر: لم يستخدم العميل خيار الاسترداد الذاتي المبكر لهذا الطلب من قبل.
الإلغاء المبكر: لم يتم تسليم الطلب بالكامل (التسليم الجزئي يؤدي إلى استرداد نسبي للجزء غير المُسلَّم).
الإلغاء المبكر: المبلغ القابل للاسترداد لا يزال متاحًا (المبلغ المسترد أقل من إجمالي الطلب).
الإلغاء المبكر: لا يوجد نزاع نشط على الطلب.
الإلغاء المبكر: لا يوجد سحب من المورد في الحالة المطلوبة أو المكتملة.

عندما تكون قيمة 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"
}

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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.

[
  {
    "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	عذرًا، لم يتم توفير أي نص للترجمة. يُرجى إدراج المحتوى المراد ترجمته إلى العربية.

[
  {
    "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. الحصول على حالة طلب الرسائل القصيرة

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

مفتاح API الخاص بك

اختبار API

نقطة نهاية API

اختياري (lang)

احصل على الفئات

طلب مثال:

مثال على الرد:

معلومات الفئة الفرعية

طلب مثال:

مثال على الرد:

قائمة المتاجر

طلب مثال:

قائمة المنتجات

طلب مثال:

قائمة الخدمات

طلب مثال:

مثال على الرد:

فحص المخزون

طلب مثال:

مثال على الرد (SMM):

مثال على الرد (منتج):

إضافة طلب

طلب مثال:

مثال على الرد:

حالة الطلب

طلب مثال:

مثال على الرد:

مثال على الاستجابة (طلب منتج مع تسليم الحسابات):

الحالات المحتملة:

إلغاء

طلب مثال:

مثال على الرد:

السماح بالإلغاء

طلب مثال:

مثال على الرد:

الرصيد

طلب مثال:

مثال على الرد:

SMS Verification API

1. احصل على مشاريع SMS

2. احصل على دول الرسائل القصيرة

3. إنشاء طلب عبر الرسائل القصيرة

4. احصل على رمز الرسائل النصية

5. الحصول على حالة طلب الرسائل القصيرة

ردود الأخطاء

طرق الدفع المدعومة

مفتاح API الخاص بك

اختبار API

نقطة نهاية API

اختياري (lang)

احصل على الفئات

طلب مثال:

مثال على الرد:

معلومات الفئة الفرعية

طلب مثال:

مثال على الرد:

قائمة المتاجر

طلب مثال:

قائمة المنتجات

طلب مثال:

قائمة الخدمات

طلب مثال:

مثال على الرد:

فحص المخزون

طلب مثال:

مثال على الرد (SMM):

مثال على الرد (منتج):

إضافة طلب

طلب مثال:

مثال على الرد:

حالة الطلب

طلب مثال:

مثال على الرد:

مثال على الاستجابة (طلب منتج مع تسليم الحسابات):

الحالات المحتملة:

إلغاء

طلب مثال:

مثال على الرد:

السماح بالإلغاء

طلب مثال: