منصة ومتجر F-PRO PLATFORM

جميع الطلبات البرمجية توجه إلى النطاق الرسمي https://api.fakhama.shop/api/v1. يمكنك البحث الفوري داخل المسارات أو نسخ البيانات أو فتح الأمثلة بـ 4 لغات.

URL: https://api.fakhama.shop/api/v1/services/list?api_key=YOUR_API_KEY_HERE&chat_id=1234&email=a@b.com

URL: https://api.fakhama.shop/api/v1/user/balance
Body: {"api_key": "YOUR_API_KEY_HERE", "chat_id": 1234, "email": "a@b.com"}

URL: https://api.fakhama.shop/api/v1/services/order-sms
Body: {"api_key": "YOUR_API_KEY_HERE", "chat_id": 1234, "email": "a@b.com", "service_id": "id_here"}

URL: https://api.fakhama.shop/api/v1/services/order-ai
Body: {"api_key": "YOUR_API_KEY_HERE", "chat_id": 1234, "email": "a@b.com", "service_id": "vb_prod_xxxx"}

URL: https://api.fakhama.shop/api/v1/services/get-sms
Body: {"api_key": "YOUR_API_KEY_HERE", "chat_id": 1234, "email": "a@b.com", "order_id": 15}

URL: https://api.fakhama.shop/api/v1/services/cancel-sms
Body: {"api_key": "YOUR_API_KEY_HERE", "chat_id": 1234, "email": "a@b.com", "order_id": 15}

URL: https://api.fakhama.shop/api/v1/services/tele-list?api_key=YOUR_API_KEY_HERE&chat_id=1234&email=a@b.com

URL: https://api.fakhama.shop/api/v1/services/buy-tele
Body: {"api_key": "YOUR_API_KEY_HERE", "chat_id": 1234, "email": "a@b.com", "country": "US"}

URL: https://api.fakhama.shop/api/v1/services/get-tele-code
Body: {"api_key": "YOUR_API_KEY_HERE", "chat_id": 1234, "email": "a@b.com", "order_id": "order_hash_here"}

اختر العملية وعدّل بيانات المثال أدناه؛ سيتم تحديث الكود البرمجي تلقائياً في جميع اللغات (PHP cURL, JavaScript Fetch, Python Requests, cURL) مع تضمين معالجة أخطاء HTTP، مهلات الاتصال (Timeouts)، والتحقق من صحة JSON.

Content-Type: application/json
Accept: application/json

يوضح هذا المعرض الحالات الـ 8 التي يجب على المطور التعامل معها عند بناء واجهة المستخدم، مع إمكانية معاينة استجابة JSON الأصلية وشجرتها التفاعلية لكل حالة. قاعدة ذهبية: لا تعرض حالة نجاح للعميل إلا إذا كان data.status === "success" صراحةً.

عند استدعاء مسار GET /api/v1/services/list، يعيد الخادم كائن JSON يحتوي على المصفوفة data. خدمات sms تحتوي عادةً على app_name, country_name, country_flag، بينما خدمات ai و vip و ready_tele تعتمد على name و service_id و price.

1. بنية JSON المستلمة من البوابة

{
  "status": "success",
  "data": [
    {
      "service_id": "wa_sa_01",
      "type": "sms",
      "app_name": "WhatsApp",
      "country_name": "السعودية",
      "country_flag": "🇸🇦",
      "price": "18.50"
    },
    {
      "service_id": "vb_prod_chatgpt_plus",
      "type": "ai",
      "name": "ChatGPT Plus 1 Month",
      "price": "450.00"
    },
    {
      "service_id": "vb_prod_vip_netflix",
      "type": "vip",
      "name": "اشتراك VIP بريميوم شهري",
      "price": "190.00"
    },
    {
      "service_id": "US",
      "type": "ready_tele",
      "name": "US - تيليجرام جاهز",
      "price": "65.00"
    }
  ]
}

2. كيف يتم تحويل JSON إلى بطاقات في Store

SMS ● متاح

🇸🇦

WhatsApp

السعودية | wa_sa_01

18.50 ₽

معاينة الاختيار

AI ● متاح

ChatGPT Plus 1 Month

vb_prod_chatgpt_plus

450.00 ₽

معاينة الاختيار

👆 اضغط على أي بطاقة أعلاه لمشاهدة كيف يحدد التطبيق المسار المناسب (/order-sms أو /order-ai أو /buy-tele) تلقائياً بناءً على حقل type و service_id.

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

تأتي باقات الاشتراكات وخدمات الذكاء الاصطناعي ضمن مسار GET /api/v1/services/list مميزة بالحقل type: "ai" أو type: "vip". يتم شراؤها عبر إرسال service_id إلى المسار POST /api/v1/services/order-ai.

✨ أمثلة بصرية لبطاقات باقات AI و VIP (محاكاة تعليمية)

نوع الخدمة: AI ● متاح للتسليم الفوري

باقة ChatGPT Plus — اشتراك شهري

المعرف: vb_prod_gpt4_1m | المدة: 30 يوم

450.00 ₽

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

نوع الخدمة: VIP ● متاح للتسليم الفوري

عضوية VIP الرقمية الشاملة

المعرف: vb_prod_vip_pro | الحالة: نشط

280.00 ₽

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

نوع الخدمة: AI ● متاح للتسليم الفوري

اشتراك Claude Pro AI

المعرف: vb_prod_claude_pro | المدة: شهري

520.00 ₽

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

// 1. جلب الخدمات وتصنيف AI و VIP
const res = await fetch("https://api.fakhama.shop/api/v1/services/list?api_key=KEY&chat_id=ID&email=EMAIL");
const json = await res.json();
const subscriptions = json.data.filter(item => item.type === "ai" || item.type === "vip");

// 2. تنفيذ طلب شراء الباقة المختارة
const orderRes = await fetch("https://api.fakhama.shop/api/v1/services/order-ai", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    api_key: "YOUR_API_KEY_HERE",
    chat_id: 123456789,
    email: "user@example.com",
    service_id: subscriptions[0].service_id
  })
});
const orderData = await orderRes.json();
// عرض بيانات الاشتراك المسلمة في واجهة المستخدم الآمنة

{
  "status": "success",
  "order_id": 40821,
  "service_id": "vb_prod_gpt4_1m",
  "product": "Account: pro_user@domain.com\nPass: [MASKED_DEMO_PASS]\nExpires: 30 Days"
}

يوفر النظام 3 مسارات مخصصة لحسابات تيليجرام الجاهزة: استعراض الدول المتاحة عبر GET /api/v1/services/tele-list، شراء الحساب عبر POST /api/v1/services/buy-tele بإرسال رمز الدولة country، ثم استلام كود الدخول عبر POST /api/v1/services/get-tele-code.

{
  "api_key": "YOUR_API_KEY_HERE",
  "chat_id": 1234,
  "email": "a@b.com",
  "country": "US"
}

{
  "status": "success",
  "order_id": "tele_ord_88219",
  "phone": "+12025550198",
  "code": "54921"
}

تعتمد منصة F-PRO PLATFORM على التحقق الثلاثي في كل طلب برمجي (سواء عبر Query Parameters في طلبات GET أو داخل JSON Body في طلبات POST) لضمان أمان حسابات المشتركين.

📋 جدول أكواد الاستجابة والأخطاء (HTTP & API Error Codes)