PLUS | بلاس
فتح البوت
واجهة البرمجة تعمل

PLUS API
توثيق واضح واختبار مباشر

نفّذ الطلبات، استعلم عن الحالة، اعرض الخدمات والرصيد من خلال واجهة بسيطة تعتمد JSON وتدعم GET وPOST.

https://hamadh.net/api/v2
بدء سريع

طريقة استخدام الواجهة

أربع خطوات فقط لتنفيذ أول طلب.

1

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

استخدم مفتاح API الخاص بحساب العميل.

2

اختر العملية

الرصيد، الخدمات، الطلب أو حالة الطلب.

3

أرسل البيانات

مرّر الحقول المطلوبة عبر GET أو JSON.

4

اقرأ النتيجة

ستعود النتيجة بصيغة JSON واضحة.

Endpoints

العمليات المتاحة

كل الأمثلة تستخدم الرابط الأساسي الحالي.

GET

معرفة الرصيد

لا يحتاج إلا إلى مفتاح API.

مثال الطلب
https://hamadh.net/api/v2?action=balance&api_key=YOUR_API_KEY
مثال الاستجابة
{\n  "success": true,\n  "balance_usd": 25,\n  "balance_formatted": "$25.00",\n  "user_id": 123456789\n}
GET

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

يعيد معرف الخدمة والحد الأدنى والأقصى وسعر كل 1000.

مثال الطلب
https://hamadh.net/api/v2?action=services&api_key=YOUR_API_KEY
مثال الاستجابة
{\n  "success": true,\n  "services": [\n    {\n      "service_id": 1001,\n      "name": "Instagram Followers",\n      "min": 100,\n      "max": 10000,\n      "price_per_1000_usd": 1.5\n    }\n  ]\n}
POST

تقديم طلب جديد

أرسل معرف الخدمة والكمية والرابط.

مثال الطلب
curl -X POST 'https://hamadh.net/api/v2' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{"action":"order","service_id":1001,"quantity":1000,"link":"https://example.com"}'
مثال الاستجابة
{\n  "success": true,\n  "order_number": 12550,\n  "smm_order_id": "845921",\n  "price_usd": 1.5,\n  "balance_after_usd": 23.5\n}
GET

معرفة حالة الطلب

استخدم رقم الطلب الداخلي order_number.

مثال الطلب
https://hamadh.net/api/v2?action=order_status&order_number=12550&api_key=YOUR_API_KEY
مثال الاستجابة
{\n  "success": true,\n  "order_number": 12550,\n  "service_name": "Instagram Followers",\n  "quantity": 1000,\n  "remains": 300,\n  "status": "In progress",\n  "price_usd": 1.5\n}
GET

شراء Gemini Pro

شراء اشتراك Gemini Pro مباشرة من رصيد العميل.

مثال الطلب
https://hamadh.net/api/v2?action=gemini_purchase&api_key=YOUR_API_KEY
مثال الاستجابة
{\n  "success": true,\n  "order_number": 12551,\n  "product": "Gemini Pro",\n  "plan": "18 شهر",\n  "price_usd": 0.99,\n  "activation_link": "https://example.com/activation"\n}
Live Tester

اختبر واجهة البرمجة

أدخل مفتاح العميل واختر العملية، وستظهر الحقول المطلوبة تلقائيًا.

تنبيه: سيتم تنفيذ العملية بشكل حقيقي ومباشر على الحساب، وليست تجربة وهمية. تأكد من صحة جميع البيانات قبل الإرسال.
الرابط أو أمر cURL الناتج
اختر العملية وأدخل البيانات.
جاهز للاختبار
ستظهر استجابة API هنا...
الأخطاء

أكواد الاستجابة

200

تمت معالجة العملية بنجاح.

400

بيانات ناقصة أو طلب غير صالح.

401

مفتاح API مفقود أو غير صالح.

404 / 405

طلب غير موجود أو طريقة غير مدعومة.