توثيق واجهة برمجة التطبيقات (API)

معلومات عامة

عنوان API الأساسي:

https://satofill.com/wp-json/mystore/v1

المصادقة

يمكنك الحصول على الـ api token الخاص بك من صفحة اعدادات الحساب في الاسفل

اعدادات الحساب

ترويسة الطلب المطلوبة

X-API-Token: YOUR_API_TOKEN

GET جلب المنتجات المتاحة

/products

يقوم بجلب قائمة المنتجات المتاحة مع تفاصيلها.

الاستجابة الناجحة (200)

[
    {
        "id": 123,
        "name": "اسم المنتج",
        "price": "99.99",
        "stock_status": "instock",
        "min_purchase_quantity": 1,
        "max_purchase_quantity": 10
    }
]

الاستجابات الخاطئة

401 Unauthorized

{
    "code": "invalid_token",
    "message": "Token is required",
    "status": 401
}

POST إنشاء طلب جديد

/create-order
ملاحظة: تأكد من توفر رصيد كافٍ في محفظتك قبل إنشاء الطلب.

معاملات الطلب (JSON)

المعامل النوع إلزامي الوصف
product_id integer نعم معرف المنتج المراد شراؤه
quantity integer نعم الكمية المطلوبة (يجب أن تكون ضمن الحد الأدنى والأقصى للمنتج)
urlsocial string نعم معرف اللاعب في PUBG Mobile (مثال: 5287147852)

مثال للطلب

{
    "product_id": 123,
    "quantity": 1,
    "urlsocial": "5287147852"
}

الاستجابة الناجحة (200)

{
    "success": true,
    "order_id": 456,
    "total_amount": 99.99,
    "remaining_balance": 150.00
}

الاستجابات الخاطئة

400 Bad Request - بيانات غير صحيحة

{
    "code": "missing_data",
    "message": "البيانات المطلوبة غير مكتملة",
    "status": 400
}

400 Bad Request - رصيد غير كافي

{
    "code": "insufficient_funds",
    "message": "رصيد المحفظة غير كافٍ. الرجاء شحن محفظتك",
    "status": 400
}

POST جلب تفاصيل الطلب

/order

معاملات الطلب (JSON)

المعامل النوع إلزامي الوصف
order_id integer نعم معرف الطلب المراد الاستعلام عنه

مثال للطلب

{
    "order_id": 456
}

الاستجابة الناجحة (200)

{
    "order_id": 456,
    "status": "completed",
    "total": 99.99,
    "products": ["اسم المنتج"]
}

الاستجابات الخاطئة

404 Not Found

{
    "code": "invalid_order",
    "message": "الطلب المطلوب غير موجود",
    "status": 404
}

GET الاستعلام عن رصيد المحفظة

/wallet-balance

الاستجابة الناجحة (200)

{
    "success": true,
    "balance": 150.00
}

الاستجابات الخاطئة

500 Internal Server Error

{
    "code": "wallet_not_found",
    "message": "إضافة المحفظة غير مفعّلة",
    "status": 500
}