توثيق API

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

اختبار API

حدد إجراءً، واملأ المعاملات، وأرسل طلبًا. عند تسجيل الدخول، يتم تحميل مفتاح واجهة برمجة التطبيقات (API) الخاص بك تلقائيًا.

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

نقطة نهاية API

يجب إرسال جميع طلبات API عبر HTTP POST إلى نقطة النهاية هذه.

اختياري (lang)

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

مدعوم في عمليات القراءة: categories, subcategory_info, services, products, inventory ((أسماء المنتجات الفرعية)), sms_projects, و sms_countries. احذف lang أو استخدم en للإنجليزية.

تستخدم معلمات تصفية الفئة والفئة الفرعية في الخدمات/المنتجات دائمًا الأسماء الإنجليزية الرسمية، حتى عند تعيين اللغة.

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

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

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

طلب مثال:

curl -X POST https://hstockplus.net/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"]
    }
  ]
}

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

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

طلب مثال:

curl -X POST https://hstockplus.net/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"
  }
}

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

قائمة المتاجر النشطة مع المعلومات الأساسية، عدد المنتجات، وتقييمات المراجعات. أسماء المتاجر مخفية لأسباب تتعلق بالخصوصية.

طلب مثال:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops"

مع التقسيم إلى صفحات:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=shops" \
  -d "page=1" \
  -d "limit=20"

قائمة الكوبونات

اعرض رموز كوبونات جميع المتاجر التي يمكن استخدامها الآن مع الشروط المطلوبة لكل منها. مرّر الرمز كـ coupon إلى action=add. وتُدرج الرموز المخصصة لحسابك فقط (مثل عرض سعر الجملة من تذكرة) وتُوسَم بأنها private.

طلب مثال:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=coupons"

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

{
  "coupons": [
    {
      "code": "SAVE10",
      "type": "percentage",
      "value": 10,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "shop",
      "minPurchase": 20,
      "remainingUses": 87,
      "expiresAt": "2026-11-30T23:59:59.000Z"
    },
    {
      "code": "BULK500",
      "type": "percentage",
      "value": 5,
      "shopId": "6650a1f77bcf86cd79943901",
      "shopSlug": "example-shop",
      "shopName": "Example Shop",
      "appliesTo": "services",
      "services": [110469, 110470],
      "minQuantity": 100,
      "quantityTiers": [
        { "minQuantity": 100, "value": 5 },
        { "minQuantity": 500, "value": 12 }
      ],
      "maxUsesPerUser": 1,
      "remainingUses": 40
    }
  ],
  "total": 2
}

يُخصم الكوبون من المبلغ المتبقي بعد خصم الموزّع. تُحذف الحقول الاختيارية إذا لم يكن للكوبون شرط مقابل لها.

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

قائمة منتجات السوق فقط (بدون خدمات وسائل التواصل الاجتماعي). نفس حقول صفوف المنتجات في قائمة الخدمات، بما في ذلك id (معرف كيان المنتج)، service (رقم الخدمة الودي)، description و imageUrl. اختياري productIds يعيد فقط تلك المنتجات (أرقام الخدمة الودية من القائمة و/أو معرفات كيان المنتج، مفصولة بفواصل أو مصفوفة JSON، بحد أقصى 100). اختياري sort=sold يرتب النتائج حسب وحدات الطلب المدفوعة تنازليًا (الأكثر مبيعًا أولاً).

طلب مثال:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products"

التصفية حسب معرفات المنتج:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "productIds=2,5,9"

مع التقسيم إلى صفحات:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "page=1" \
  -d "limit=50"

تصفية حسب الفئة أو الفئة الفرعية:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "category=Accounts-Email"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=products" \
  -d "subcategory=Gmail"

الأكثر مبيعًا في فئة فرعية:

curl -X POST https://hstockplus.net/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.net/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 لتصفية المنتجات فقط.

طلب مثال:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "lang=zh"

مع التقسيم إلى صفحات:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "page=1" \
  -d "limit=50"

تصفية حسب الفئة أو الفئة الفرعية:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "category=Instagram"
# Or filter by subcategory:
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=services" \
  -d "subcategory=Followers"

تصفية حسب نوع الكيان:

curl -X POST https://hstockplus.net/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",
      "sold": 5300,
      "sellerRating": 4.0,
      "sellerReviewCount": 30,
      "returningBuyerRate": 0.52,
      "warrantyHours": 12
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

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

تحمل صفوف المنتجات أيضًا الأرقام الظاهرة في صفحة المنتج: service هو رقم المنتج (#48071 في الصفحة)، وsellerRating وsellerReviewCount هما تقييم البائع بالنجوم وعدد تقييماته، وreturningBuyerRate هي نسبة المشترين العائدين لدى البائع (0.52 = 52%)، وsold هو عدد الوحدات المباعة، وwarrantyHours هي مدة خدمة ما بعد البيع بالساعات محسوبة من وقت التسليم (0 = لا توجد خدمة ما بعد البيع). وتُحذف sellerRating وsellerReviewCount وreturningBuyerRate إذا لم يكن للبائع تقييم أو كان عدد مشتريه قليلًا جدًا.

فحص المخزون

احصل على المخزون الحالي وحالة التوفر لخدمة ما عبر معرّفها (وهو المعرّف نفسه في قائمة الخدمات). وبالنسبة إلى منتجات السوق يتضمن JSON الحقل subproducts: مصفوفة بالخيارات النشطة، لكل منها subproductId وname وstock (المخزون المعروض لذلك الخيار) وسعره وحدود طلبه الخاصة: available وrate وmin وmax، إضافةً إلى packs للخيارات المباعة في حزم ثابتة.

طلب مثال:

curl -X POST https://hstockplus.net/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, "available": true, "rate": "25.0000", "min": 1, "max": 42 },
    { "subproductId": "674a1f77bcf86cd799439012", "name": "3 Months", "stock": 0, "available": false, "rate": "60.0000", "min": 1, "max": 0 },
    {
      "subproductId": "674a1f77bcf86cd799439013", "name": "Pack", "stock": 500, "available": true, "rate": "0.0190", "min": 100, "max": 100,
      "packs": [
        { "quantity": 100, "price": "1.9000", "discountPercent": 5 },
        { "quantity": 500, "price": "9.0000", "discountPercent": 10 }
      ]
    }
  ],
  "warrantyHours": 24
}

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

لكل منتج فرعي سعره وحدّه الأدنى والأقصى: وهذا هو سعر الوحدة ونطاق الكمية اللذان تُحتسب بهما رسوم add عند تمرير subproductId، قبل أي خصم موزّع على حسابك. وبالنسبة إلى الخيارات المباعة في حزم ثابتة، تسرد packs كل حزمة متوفرة (quantity وtotal price وdiscountPercent) ويجب طلب إحدى هذه الكميات؛ وتصف rate وmin وmax عندئذٍ أصغر حزمة.

warrantyHours (products only) is the product's after-sales window in hours counted from delivery, the same figure as in the services list; 0 means no after-sales.

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. For products with multiple options (Select Option on the website), pass subproductId (from action=inventory) to choose which option to order — otherwise the default option is used.

طلب مثال:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://instagram.com/username" \
  -d "quantity=1000"

# Product with multiple options: pick the subproductId from action=inventory
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=1" \
  -d "subproductId=674a1f77bcf86cd799439012"

# With a coupon code from action=coupons
curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=110469" \
  -d "quantity=10" \
  -d "coupon=SAVE10"

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

{
  "order": 23501,
  "entityType": "product",
  "charge": "22.5000",
  "couponDiscount": "2.5000",
  "warrantyHours": 24
}

charge is what was taken from your balance. couponDiscount is present only when a coupon was applied. warrantyHours (products only) is the after-sales window in hours counted from delivery, 0 = no after-sales; action=status returns the exact end time as warranty_expires_at.

حالة الطلب

الحصول على حالة الطلب.

طلب مثال:

curl -X POST https://hstockplus.net/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"
  ]
}

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

يُرجع الطلب المسترد بالكامل الحالة Canceled، ويُرجع الطلب المسترد جزئيًا الحالة Partial. وعند استرداد أي مبلغ تتضمن الاستجابة أيضًا الحقل "refunded" بقيمة المبلغ المسترد بالدولار الأمريكي.

مثال على الاستجابة (طلب منتج مُسلَّم كملفات):

تُسلَّم بعض المنتجات (مثل حسابات Telegram المرفقة بأرشيفات الجلسات) كملفات ZIP بدلًا من بيانات الدخول النصية أو إضافةً إليها. وتتضمن الاستجابة حينئذٍ مصفوفة "files". كل ملف يمثل عنصرًا مُسلَّمًا. نزّل الملف باستخدام action=order_file.

{
  "status": "Completed",
  "charge": "12.00",
  "start_count": 0,
  "remains": 0,
  "currency": "USD",
  "entityType": "product",
  "autoDelivery": false,
  "files": [
    {
      "id": "66e6b2f0c3a1d2e4f5a6b7c8",
      "name": "sessions-001.zip",
      "size": 482113,
      "uploaded_at": "2026-09-15T08:30:00.000Z"
    }
  ]
}

تنزيل ملف الطلب

تنزيل ملف تسليم واحد (ZIP) لطلبك. عند النجاح يكون جسم الاستجابة هو الملف نفسه (Content-Type: application/zip)، وعند الفشل يكون JSON يحتوي على الحقل "error".

طلب مثال:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=order_file" \
  -d "order=23501" \
  -d "file=66e6b2f0c3a1d2e4f5a6b7c8" \
  -o sessions-001.zip

مثال على استجابة الخطأ:

{
  "error": "File not found"
}

تحقق من ترويسة Content-Type قبل الحفظ: القيمة application/zip تعني أنه الملف، والقيمة application/json تعني وجود خطأ.

إلغاء

إلغاء طلب أو أكثر (بصيغة دفعية متوافقة مع PerfectPanel). يتم رد قيمة كل طلب مؤهل إلى رصيدك.

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

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

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

طلب مثال:

curl -X POST https://hstockplus.net/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" للتحقق من الأهلية دون معالجة استرداد.

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

عندما تكون قيمة allowcancel تساوي 1، يتضمن الرد refundAmount (المبلغ الذي سيتم استرداده عند الإلغاء).

طلب مثال:

curl -X POST https://hstockplus.net/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"
  }
]

الرصيد

احصل على رصيدك الحالي.

طلب مثال:

curl -X POST https://hstockplus.net/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"

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

{
  "balance": "100.00",
  "currency": "USD"
}

واجهة SMS Verification API

نقاط نهاية مخصصة لخدمات التحقق عبر الرسائل القصيرة.

لطلبات SMS معرّفات طلبات خاصة بها. استخدم معها sms_code وsms_status وsms_cancel؛ أما status وcancel وallowcancel فهي لطلبات المنتجات وSMM فقط.

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

[
  {
    "country_code": "+1",
    "country_name": "United States"
  },
  {
    "country_code": "+44",
    "country_name": "United Kingdom"
  }
]

{
  "orders": [
    {
      "order": 12345,
      "phone": "4055123415",
      "dial_code": "+1",
      "phone_full": "+14055123415",
      "country": "US",
      "expires_at": "2026-01-01T12:15:00.000Z",
      "status": "active"
    }
  ]
}

{
  "status": "completed",
  "code": "123456",
  "sms_content": "Your verification code is 123456"
}
// OR
{
  "status": "waiting",
  "message": "Waiting for code"
}
// OR, once expires_at has passed without a code (call sms_cancel for a refund)
{
  "status": "expired",
  "message": "No code arrived before the number expired. Call action=sms_cancel for a refund."
}

{
  "status": "code_received",
  "phone": "4055123415",
  "dial_code": "+1",
  "phone_full": "+14055123415",
  "code": "123456",
  "charge": "0.5000",
  "currency": "USD",
  "refunded": false,
  "expires_at": "2026-01-01T12:15:00.000Z"
}
// status: phone_acquired | code_received | expired | released

{
  "order": 12345,
  "status": "cancelled",
  "refunded": true,
  "refund_amount": "0.5000",
  "currency": "USD"
}
// OR
{
  "error": "Verification code already received, cannot release"
}

ردود الأخطاء

الاستجابات الخطأ الشائعة التي قد تواجهها.