📚 توثيق API - Telegram Bot

GET 🔓 عام

/api/health

التحقق من صحة الخادم وحالة التطبيق

# طلب curl -X GET https://devill-api.xyz/api/health # الرد { "status": "healthy", "timestamp": 1780566443.2720773 }

GET 🔒 يتطلب مصادقة

/api/balance

جلب رصيد المستخدم الحالي بالدولار

# طلب curl -X GET https://devill-api.xyz/api/balance \ -H "X-API-Key: مفتاحك_هنا" # الرد { "success": true, "user_id": 152512936, "balance_usd": 15.50 }

GET 🔒 يتطلب مصادقة

/api/countries

جلب قائمة الدول المتاحة مع أسعارها

# طلب curl -X GET https://devill-api.xyz/api/countries \ -H "X-API-Key: مفتاحك_هنا" # الرد { "success": true, "countries": [ {"name": "السعودية", "calling_code": "966", "price": 1.2} ] }

POST 🔒 يتطلب مصادقة

/api/buy

شراء حساب (أو عدة حسابات) من دولة محددة

calling_code *	رمز الدولة (مثال: 966)
quantity اختياري	العدد (الافتراضي: 1، الحد الأقصى: 5)

# طلب curl -X POST https://devill-api.xyz/api/buy \ -H "X-API-Key: مفتاحك_هنا" \ -H "Content-Type: application/json" \ -d '{"calling_code": "966", "quantity": 1}' # الرد { "success": true, "data": { "accounts": [ {"order_id": "order_xxx", "phone": "9665xxxxxx"} ] } }

POST 🔒 يتطلب مصادقة

/api/get_code

جلب كود التحقق من تيليجرام (بعد الشراء)

order_id *

معرف الطلب من عملية الشراء

# طلب curl -X POST https://devill-api.xyz/api/get_code \ -H "X-API-Key: مفتاحك_هنا" \ -H "Content-Type: application/json" \ -d '{"order_id": "order_xxx"}' # الرد { "success": true, "data": { "code": "12345", "phone": "9665xxxxxx" } }

POST 🔒 يتطلب مصادقة

/api/logout

تسجيل الخروج من حساب تيليجرام

order_id *

معرف الطلب

# طلب curl -X POST https://devill-api.xyz/api/logout \ -H "X-API-Key: مفتاحك_هنا" \ -H "Content-Type: application/json" \ -d '{"order_id": "order_xxx"}' # الرد { "success": true, "message": "Logged out successfully" }

GET 🔒 يتطلب مصادقة

/api/orders

جلب جميع طلبات المستخدم الحالي

# طلب curl -X GET https://devill-api.xyz/api/orders \ -H "X-API-Key: مفتاحك_هنا" # الرد { "success": true, "total": 8, "orders": [...] }

GET 🔒 يتطلب مصادقة

/api/order/{order_id}

جلب تفاصيل طلب محدد

order_id *

معرف الطلب (في الرابط)

# طلب curl -X GET https://devill-api.xyz/api/order/order_xxx \ -H "X-API-Key: مفتاحك_هنا" # الرد { "success": true, "data": { "order_id": "order_xxx", "phone": "9665xxxxxx", "status": "completed" } }