PLUS API التوثيق
● API متاح الآن

واجهة PLUS API
للخدمات والاشتراكات

استخدم واجهة البرمجة لإظهار الخدمات، معرفة الرصيد، إنشاء طلبات SMM، متابعة حالة الطلبات، وشراء اشتراك Gemini Pro مع استلام رابط التفعيل مباشرة.

Base URLhttps://hamadh.net/plus/api.php
صيغة الردJSON أو Text
طرق الطلبGET و POST
إعداد الأمثلة تلقائيًا

أدخل مفتاح حسابك، وسيتم تحديث جميع الأمثلة في الصفحة. لا يتم إرسال المفتاح إلى أي مكان.

المصادقة

يمكن إرسال المفتاح بطريقتين.

1) عبر الرابط

URL 

                    

                    
2) عبر Authorization Bearer

                    

                        HEADER
                        

                    

                    
لا تعرض مفتاح API داخل واجهة البوت أو رسائل المستخدم، واحفظه داخل ملف إعدادات آمن.

                

            

        


        

            
معرفة الرصيد
إرجاع الرصيد الحالي المرتبط بمفتاح API.

            

                
GET?action=balance

                

                    

                        
المعاملالحالةالوصف

                        
actionمطلوبالقيمة: balance

                        
api_keyمطلوبمفتاح API الخاص بالحساب

                        
formatاختياريjson أو text

                    

                    
REQUEST

                    
RESPONSE
{
  "success": true,
  "balance_usd": 3.134366,
  "balance_formatted": "1,692.56﷼ش",
  "user_id": 123456789
}

                

            

        


        

            
قائمة الخدمات
عرض جميع خدمات SMM المتاحة ومعرفاتها وأسعارها وحدودها.

            

                
GET?action=services

                

                    
REQUEST

                    
RESPONSE
{
  "success": true,
  "services": [
    {
      "service_id": 101,
      "name": "متابعين إنستجرام | فوري",
      "min": 100,
      "max": 100000,
      "price_per_1000_usd": 1.55
    },
    {
      "service_id": 102,
      "name": "مشاهدات تيك توك",
      "min": 1000,
      "max": 1000000,
      "price_per_1000_usd": 0.25
    }
  ]
}

                

            

        


        

            
إضافة طلب خدمة
إنشاء طلب SMM وخصم قيمته من رصيد حساب API.

            

                
GET?action=order

                

                    

                        
المعاملالحالةالوصف

                        
service_idمطلوبمعرف الخدمة من قائمة الخدمات

                        
quantityمطلوبالكمية ضمن الحد الأدنى والأقصى

                        
linkمطلوبرابط الحساب أو المنشور المطلوب

                    


                    

                        
                        
                    

                    

                        
GET REQUEST

                    

                    

                        
CURL

                    


                    
SUCCESS RESPONSE
{
  "success": true,
  "order_number": 6281,
  "smm_order_id": "98452137",
  "price_usd": 1.55,
  "balance_after_usd": 4.29
}


                    
ERROR RESPONSE
{
  "success": false,
  "error": "INSUFFICIENT_BALANCE",
  "message": "رصيد غير كافٍ"
}

                

            

        


        

            
معرفة حالة الطلب
الاستعلام بواسطة رقم الطلب الداخلي الذي أعاده API.

            

                
GET?action=order_status

                

                    

                        
المعاملالحالةالوصف

                        
order_numberمطلوبرقم الطلب مثل 6281

                    

                    
REQUEST

                    
RESPONSE
{
  "success": true,
  "order_number": 6281,
  "service_name": "متابعين إنستجرام | فوري",
  "quantity": 1000,
  "remains": 250,
  "status": "processing",
  "price_usd": 1.55
}

                

            

        


        

            
شراء Gemini Pro
شراء اشتراك 18 شهر واستلام رابط التفعيل مباشرة.

            

                
GET?action=gemini

                

                    

                        ⚠️ فتح رابط الطلب ينفذ شراءً حقيقيًا فورًا، ويخصم 0.99$ من رصيد حساب API إذا كان المخزون والرصيد متوفرين.
                    

                    
PURCHASE REQUEST

                    
يمكن أيضًا استخدام action=gemini_purchase.


                    
SUCCESS RESPONSE
{
  "success": true,
  "order_number": 6280,
  "product": "Gemini Pro",
  "plan": "18 شهر",
  "price_usd": 0.99,
  "balance_after_usd": 2.1443659999999998,
  "activation_link": "https://serviceactivation.google.com/subscription/new/...",
  "remaining": 10
}


                    

                        عند النجاح، احفظ activation_link وأرسله للمستخدم مباشرة. الرابط منتج رقمي خاص ولا يُفترض مشاركته مع أكثر من عميل.
                    


                    
OUT OF STOCK
{
  "success": false,
  "error": "GEMINI_OUT_OF_STOCK",
  "message": "لا توجد اشتراكات Gemini Pro متوفرة حالياً"
}


                    
PHP EXAMPLE

                

            

        


        

            
رموز الأخطاء
أهم الأخطاء المتوقع إرجاعها من API.

            

                
MISSING_TOKEN
لم يتم إرسال مفتاح API.

                
INVALID_TOKEN
المفتاح غير صالح أو منتهي.

                
MISSING_FIELDS
أحد حقول طلب الخدمة مفقود.

                
INSUFFICIENT_BALANCE
الرصيد لا يكفي لإتمام الطلب.

                
ORDER_NOT_FOUND
رقم الطلب غير موجود للحساب.

                
GEMINI_OUT_OF_STOCK
لا يوجد مخزون Gemini حاليًا.

                
GEMINI_PRODUCT_NOT_FOUND
تعذر العثور على رابط اشتراك متاح.

                
UNKNOWN_ACTION
قيمة action غير مدعومة.