Customer API - HstockPlus

Language

ابدأ

HstockPlus/توثيق API

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

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

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

Test API

Select an action, fill in parameters, and send a request. When logged in, your API key is loaded automatically.

مفتاح API

الإجراء

نقطة نهاية API

https://hstockplus.com/api/v2

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

Get Categories

Get all categories and each category's subcategories. Use these values to filter the Services List by category or subcategory.

Parameter	Description	Required
key	Your API key	Yes
action	categories	Yes

طلب مثال:

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

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

{
  "categories": [
    {
      "category": "Instagram",
      "subcategories": ["Followers", "Comments", "Likes"]
    },
    {
      "category": "Email Accounts",
      "subcategories": ["Gmail", "Outlook"]
    }
  ]
}

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

Get all available services with optional pagination. Each service includes stock (available quantity). Optional category and subcategory parameters return only services in that category or subcategory (values from the Get Categories API).

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

طلب مثال:

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

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

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

Filter by category or subcategory:

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"

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

{
  "services": [
    {
      "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
    },
    {
      "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
    }
  ],
  "total": 150,
  "page": 1,
  "limit": 50,
  "total_pages": 3
}

Each service includes stock (available quantity), entityType (smm or product), and autoDelivery (true if the service/product is auto-delivery, false if manual). When limit is 0 or omitted, all services are returned and page/limit equal total.

فحص المخزون

احصل على المخزون الحالي والتوفر لخدمة ما باستخدام معرفها (نفس المعرف الموجود في قائمة الخدمات).

Parameter	Description	Required
key	Your API key	Yes
action	inventory	Yes
service	Service ID (from services list)	Yes

طلب مثال:

curl -X POST https://hstockplus.com/api/v2 \
  -d "key=YOUR_API_KEY" \
  -d "action=inventory" \
  -d "service=23501"

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

{
  "service": 23501,
  "stock": 42,
  "available": true,
  "entityType": "product",
  "autoDelivery": true
}

Response includes entityType (smm or product) and autoDelivery (true = auto-delivery, false = supplier fulfills manually).

إضافة طلب

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: true if the order is fulfilled automatically (e.g. SMM, auto/inventory products); false if the supplier must fulfill manually (may take some time).

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

{
  "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. احصل على مشاريع SMS

Action: sms_projects

Parameter	Description
key	Your API key
action	sms_projects
country	Optional. Filter by country ID (e.g. 'us', 'gb')

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

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

Action: sms_countries

[
  {
    "country_code": "us",
    "country_name": "United States"
  },
  {
    "country_code": "gb",
    "country_name": "United Kingdom"
  }
]

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

Action: add_sms

Parameter	Description	Required
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
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

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

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

Test API

نقطة نهاية API

Get Categories

طلب مثال:

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

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

طلب مثال:

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

فحص المخزون

طلب مثال:

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

إضافة طلب

طلب مثال:

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

حالة الطلب

طلب مثال:

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

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

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

الرصيد

طلب مثال:

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

SMS Verification API

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

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

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

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

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

ردود الأخطاء

Supported payment methods