B
SAM STORE DEVELOPER PLATFORM

توثيق API سام ستور

اربط موقعك أو تطبيقك بالمنتجات والطلبات والرصيد بأمان.

تنزيل TXT

ابدأ بسرعة

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

Base URL: https://api.sam4game.store

المصادقة

أرسل المفتاح في كل طلب حديث باستخدام أحد الرأسين:

X-API-Key: BrazekXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Authorization: Bearer BrazekXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

مسارات التوافق القديمة تستخدم api-token. لا تضع المفتاح في تطبيق Frontend مكشوف؛ استخدم خادمك الوسيط.

GET/v1/account

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

يعيد معلومات الحساب والرصيد الحالي بعد تطبيق صلاحيات مفتاح API.

شكل الطلب
لا يوجد جسم طلب.
الرؤوس المطلوبة
X-API-Key: Brazek... Accept: application/json
مثال الاستجابة الناجحة
{
  "success": true,
  "data": {
    "id": "usr_123",
    "email": "[email protected]",
    "wallet_balance": 25.5,
    "api_enabled": true
  }
}

الأخطاء المحتملة

401 invalid_api_key — مفتاح غير صالح.
403 api_disabled — واجهة API غير مفعلة.
GET/v1/products

قائمة المنتجات

يعيد المنتجات المفعلة وأسعار المستخدم النهائية بعد الخصم والصلاحيات.

شكل الطلب
لا يوجد جسم طلب. يمكن قراءة category_id وparams وinput_schema لتجهيز نموذج الطلب.
الرؤوس المطلوبة
X-API-Key: Brazek... Accept: application/json
مثال الاستجابة الناجحة
{
  "success": true,
  "data": [
    {
      "id": 598,
      "name": "UC 60",
      "category_id": 2,
      "available": true,
      "price_usd": 1.26,
      "base_price_usd": 1.05,
      "params": [
        "Player ID"
      ],
      "input_schema": [
        {
          "label": "Player ID",
          "key": "playerId",
          "required": true
        }
      ]
    }
  ]
}

الأخطاء المحتملة

401 invalid_api_key — مفتاح غير صالح.
403 api_disabled — واجهة API غير مفعلة.
GET/v1/orders

طلبات المستخدم

يعيد الطلبات التابعة للمفتاح الحالي فقط، مع الحالة والسعر والقيمة المسلّمة.

شكل الطلب
لا يوجد جسم طلب.
الرؤوس المطلوبة
X-API-Key: Brazek... Accept: application/json
مثال الاستجابة الناجحة
{
  "success": true,
  "data": [
    {
      "id": 1710000000000,
      "order_ref": "ID_abc123",
      "product_id": 598,
      "product_name": "UC 60",
      "qty": 1,
      "amount_usd": 1.26,
      "status": "مكتمل",
      "provider_status": "accept",
      "delivered_code": null,
      "player_id": "123456789",
      "created_at": "2026-11-04 10:30"
    }
  ]
}

الأخطاء المحتملة

401 invalid_api_key — مفتاح غير صالح.
403 api_disabled — واجهة API غير مفعلة.
POST/v1/orders

إنشاء طلب وشحن الخدمة

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

شكل الطلب
{ "product_id": 598, "qty": 1, "params_values": { "playerId": "123456789" } }
الرؤوس المطلوبة
X-API-Key: Brazek... Content-Type: application/json Accept: application/json
مثال الاستجابة الناجحة
{
  "success": true,
  "message": "تم تنفيذ طلب الشحن فعلياً بنجاح!",
  "data": {
    "order": {
      "order_ref": "ID_abc123",
      "status": "مكتمل",
      "amount_usd": 1.26,
      "delivered_code": null
    },
    "wallet_balance": 24.24
  }
}

الأخطاء المحتملة

400 — بيانات المنتج أو الكمية أو الحقول غير صحيحة.
401 — مفتاح API غير صالح.
403 — الحساب محظور أو API غير مفعلة.
409 — طلب مكرر أو قيد التنفيذ.
502 — مزود الخدمة غير متاح.
GET/client/api/profile

توافق مزود الخدمة: الحساب والرصيد

مسار توافق لمن يستخدم صيغة api-token القديمة.

شكل الطلب
لا يوجد جسم طلب.
الرؤوس المطلوبة
api-token: Brazek... Accept: application/json
مثال الاستجابة الناجحة
{
  "balance": "25.5000",
  "email": "[email protected]"
}

الأخطاء المحتملة

120 Api Token is required.
121 Token error.
122 Not allowed to use API.
GET/client/api/content/{category_id}

توافق مزود الخدمة: محتوى القسم

يعيد الأقسام الفرعية والمنتجات المباشرة للقسم المطلوب. استخدم 0 للجذر.

شكل الطلب
استبدل {category_id} برقم القسم، مثل /client/api/content/2.
الرؤوس المطلوبة
api-token: Brazek... Accept: application/json
مثال الاستجابة الناجحة
{
  "categories": [
    {
      "id": 22,
      "name": "PUBG",
      "parent_id": 2,
      "category_img": ""
    }
  ],
  "products": [
    {
      "id": 598,
      "name": "UC 60",
      "price": 1.26,
      "available": true,
      "qty_values": null,
      "params": [
        "Player ID"
      ]
    }
  ]
}

الأخطاء المحتملة

121 Token error.
122 Not allowed to use API.
GET/client/api/check?orders=[ORDER_ID]

توافق مزود الخدمة: فحص حالة الطلب

يفحص طلباً واحداً أو عدة طلبات، ويعيد السعر والحالة والقيمة المسلّمة عند توفرها.

شكل الطلب
orders يقبل رقم طلب أو عدة أرقام مفصولة بفواصل. لفحص UUID استخدم uuid=1.
الرؤوس المطلوبة
api-token: Brazek... Accept: application/json
مثال الاستجابة الناجحة
{
  "status": "OK",
  "data": [
    {
      "order_id": "ID_abc123",
      "quantity": 1,
      "data": {
        "playerId": "123456789"
      },
      "created_at": "2026-11-04 10:30",
      "product_name": "UC 60",
      "price": "1.2600",
      "status": "accept",
      "replay_api": null
    }
  ]
}

الأخطاء المحتملة

121 Token error.
122 Not allowed to use API.

رموز الأخطاء والاستجابة

تعامل مع رمز HTTP أولاً، ثم اقرأ code أو error داخل JSON عند توفره.

الرمزالاسمالمعنى
120Api Token is requiredلم يتم إرسال مفتاح API.
121Token error / invalid_api_keyالمفتاح غير صحيح أو لا يتطابق مع أي مستخدم.
122Not allowed to use API / api_disabledميزة API غير مفعلة لهذا الحساب.
100Insufficient balanceالرصيد المتاح غير كافٍ.
105Quantity not availableالكمية المطلوبة غير متوفرة.
106Quantity not allowedالكمية ليست ضمن القيم المسموحة.
109Product not foundالمنتج غير موجود أو محذوف.
110Product not availableالمنتج غير متاح حالياً.
111Try again after 1 minuteأعد المحاولة بعد دقيقة.
112Quantity too smallالكمية أقل من الحد الأدنى.
113Quantity too largeالكمية أكبر من الحد الأعلى.
114Provider errorخطأ من مزود الشحن.
400Validation errorبيانات الطلب غير صحيحة.
401Authentication requiredالمصادقة مفقودة أو غير صالحة.
403Forbiddenالحساب غير مسموح أو محظور.
404Not foundالمسار أو المورد غير موجود.
409Conflictتعارض أو طلب مكرر.
429Too many requestsتم تجاوز معدل الطلبات.
500Server errorخطأ داخلي.
502Provider unavailableمزود الشحن غير متاح مؤقتاً.
{
  "success": false,
  "error": "invalid_api_key",
  "message": "مفتاح API غير صالح"
}