توثيق واجهة برمجة التطبيقات (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
}
