واجهة برمجة التطبيقات

HTTP Method	POST
API URL	https://smmxmego.com/api/v2
API Key	أنشئ حسابًا للحصول على مفتاح
Response format	JSON

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

المعامل	الوصف
key	مفتاحك في الواجهة
action	services

مثال للاستجابة

RESPONSEJSON

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

إنشاء طلب

ملاحظة: الحقول أدناه هي حقول نوع الخدمة نفسه، تمامًا كما تتحقّق منها صفحة الطلب في اللوحة — أرسل ما يعلنه نوع خدمتك ولا شيء غيره. الكمية التي تُحاسَب عليها تُحسب في الخادم بالقاعدة نفسها التي تستعملها اللوحة (وفي الاشتراكات هي max × posts)، فتتطابق تسعيرة الواجهة وتسعيرة اللوحة دائمًا.

المعامل	الوصف
key	مفتاحك في الواجهة
action	add
service	معرّف الخدمة
link	رابط الصفحة
quantity	الكمية المطلوبة
runs (optional)	عدد الدفعات
interval (optional)	الفاصل بالدقائق

مثال للاستجابة

RESPONSEJSON

{
    "order": 23501
}

حالة الطلب

المعامل	الوصف
key	مفتاحك في الواجهة
action	status
order	معرّف الطلب

مثال للاستجابة

RESPONSEJSON

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

حالة عدّة طلبات

المعامل	الوصف
key	مفتاحك في الواجهة
action	status
orders	معرّفات الطلبات مفصولة بفاصلة، حتى 100 معرّف

مثال للاستجابة

RESPONSEJSON

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

طلب إعادة تعبئة

المعامل	الوصف
key	مفتاحك في الواجهة
action	refill
order	معرّف الطلب

مثال للاستجابة

RESPONSEJSON

{
    "refill": "1"
}

إعادة تعبئة لعدّة طلبات

المعامل	الوصف
key	مفتاحك في الواجهة
action	refill
orders	معرّفات الطلبات مفصولة بفاصلة، حتى 100 معرّف

مثال للاستجابة

RESPONSEJSON

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

حالة إعادة التعبئة

المعامل	الوصف
key	مفتاحك في الواجهة
action	refill_status
refill	معرّف إعادة التعبئة

مثال للاستجابة

RESPONSEJSON

{
    "status": "Completed"
}

حالة عدّة عمليات إعادة تعبئة

المعامل	الوصف
key	مفتاحك في الواجهة
action	refill_status
refills	معرّفات إعادة التعبئة مفصولة بفاصلة، حتى 100 معرّف

مثال للاستجابة

RESPONSEJSON

[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]

طلب إلغاء

ملاحظة: هذا يسجّل طلب إلغاء ولا يحرّك مالًا. يجب أن يكون الطلب لك، وأن تسمح خدمته بالإلغاء، وألّا يكون قد سُلّم بعد. يوضع الطلب في قائمة المراجعة، وفي الخدمات التلقائية يُمرَّر إلى المزوّد فورًا.

المعامل	الوصف
key	مفتاحك في الواجهة
action	cancel
order	معرّف طلب واحد — والاستجابة `{"cancel": 1}`
orders	معرّفات طلبات مفصولة بفاصلة، حتى 100 معرّف — تُستعمل بدل `order`، والاستجابة هي المصفوفة أدناه

مثال للاستجابة

RESPONSEJSON

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]

كتالوج البطاقات

المعامل	الوصف
key	مفتاحك في الواجهة
action	cards

مثال للاستجابة

RESPONSEJSON

{
    "card_categories": [
        {
            "main_category_id": 3,
            "name": "Gift cards",
            "services": [
                {
                    "service_id": 51,
                    "name": "Card 10$",
                    "type": "code",
                    "price": "10.00",
                    "min_qty": 1,
                    "max_qty": 5,
                    "category_id": 12,
                    "description": "",
                    "image": ""
                }
            ]
        }
    ]
}

شراء بطاقة

المعامل	الوصف
key	مفتاحك في الواجهة
action	add_card
service_id	معرّف خدمة البطاقة من `action=cards`
quantity (optional)	العدد، والافتراضي 1
player_id (optional)	تطلبه بطاقات الشحن التي تحتاج معرّف لاعب أو حساب
account_user (optional)	تطلبه البطاقات التي تُسلَّم داخل حساب
account_pass (optional)	يُرسل مع `account_user`

مثال للاستجابة

RESPONSEJSON

{
    "status": "success",
    "order_id": 1204,
    "service": 51,
    "qty": 1,
    "codes": ["XXXX-XXXX-XXXX"]
}

حالة طلب بطاقة

المعامل	الوصف
key	مفتاحك في الواجهة
action	card_status
order	معرّف طلب البطاقة
orders	معرّفات طلبات بطاقات مفصولة بفاصلة — تُستعمل بدل `order`

مثال للاستجابة

RESPONSEJSON

{
    "1204": {
        "status": "completed",
        "sell_price": "10.00",
        "code": "XXXX-XXXX-XXXX"
    },
    "9": {
        "error": "Incorrect order ID."
    }
}

كتالوج المنتجات

المعامل	الوصف
key	مفتاحك في الواجهة
action	products

مثال للاستجابة

RESPONSEJSON

{
    "products": [
        {
            "product_id": 7,
            "name": "Product name",
            "category_id": 2,
            "price": "5.00",
            "discount_price": null,
            "description": "",
            "image": "",
            "fields": [
                { "label": "Account", "placeholder": "user@example.com" }
            ],
            "variants": []
        }
    ]
}

شراء منتج

المعامل	الوصف
key	مفتاحك في الواجهة
action	add_product
product_id	معرّف المنتج من `action=products`
quantity (optional)	العدد، والافتراضي 1
variants (optional)	JSON بالخيارات المختارة، إن كان للمنتج خيارات
fields (optional)	JSON بحقول المنتج المطلوبة — والحقل الناقص يُرفض باسمه
coupon_code (optional)	كود الخصم؛ تُفحص صلاحيته والحد الأدنى للمبلغ وحدّ الاستعمال

مثال للاستجابة

RESPONSEJSON

{
    "status": "success",
    "order_id": 88,
    "order_status": "pending",
    "quantity": 1,
    "total_paid": "5.00"
}

حالة طلب منتج

المعامل	الوصف
key	مفتاحك في الواجهة
action	product_status
order	معرّف طلب المنتج

مثال للاستجابة

RESPONSEJSON

{
    "order_id": 88,
    "status": "completed",
    "total_price": "5.00",
    "created_at": "2026-09-08 10:15:00"
}

رصيد المستخدم

المعامل	الوصف
key	مفتاحك في الواجهة
action	balance

مثال للاستجابة

RESPONSEJSON

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

مثال بكود PHP

المعامل	الوصف
key	مفتاحك في الواجهة
action	add
service	معرّف الخدمة
username	اسم المستخدم
min	الحد الأدنى للكمية
max	الحد الأقصى للكمية
posts (optional)	استعمله إن أردت تحديد عدد المنشورات الجديدة (المستقبلية) التي ستُقرأ وتُنشأ لها طلبات. إن لم يُرسل، يُنشأ الاشتراك لعدد غير محدود من المنشورات.
old_posts (optional)	عدد المنشورات القائمة التي ستُقرأ وتُنشأ لها طلبات، إن كانت هذه الميزة متاحة للخدمة.
delay	التأخير بالدقائق. القيم الممكنة: 0, 5, 10, 15, 20, 30, 40, 50, 60, 90, 120, 150, 180, 210, 240, 270, 300, 360, 420, 480, 540, 600
expiry (optional)	تاريخ الانتهاء بصيغة d/m/Y