واجهة برمجة تطبيقات المنتجات
الحصول على قائمة المنتجات
استرجع قائمة المنتجات الرقمية المتاحة من كتالوج SofizPay، مع إمكانية التصفية بحسب الاسم
نقطة النهاية
GET
https://sofizpay.com/services/get_products/تقوم هذه النقطة بإرجاع المنتجات المتاحة مع تصفيتها حسب التوفر وإعادة معلومات مبسطة فقط (الاسم والسعر)
تتطلب هذه النقطة مفتاحاً سرياً صالحاً من نوع Stellar للمصادقة عبر الحقل encrypted_sk
معاملات الطلب
Content-Type: application/json
| المعامل | النوع | مطلوب | الوصف |
|---|---|---|---|
encrypted_sk | string | نعم | المفتاح السري المشفر أو النصي لـ Stellar. يمكن أن يكون مفتاحاً نصياً يبدأ بـ "S" (56 حرفاً) أو مفتاحاً مشفراً بـ RSA بتشفير base64 |
search | string | لا | كلمة بحث اختيارية لتصفية المنتجات حسب الاسم |
مثال على الطلب
مثال مع كلمة البحث
bash
curl -X GET "https://sofizpay.com/services/get_products/" \
-H "Content-Type: application/json" \
-d '{
"encrypted_sk": "SBXJ...",
"search": "PUBG"
}'مثال بدون كلمة البحث (جميع المنتجات)
bash
curl -X GET "https://sofizpay.com/services/get_products/" \
-H "Content-Type: application/json" \
-d '{
"encrypted_sk": "SBXJ..."
}'استجابة ناجحة (200)
يتم إرجاع قائمة المنتجات المتاحة مع أسمائها وأسعارها بالدينار الجزائري
json
1{
2 "status": "success",
3 "count": 8,
4 "products": [
5 {
6 "name": "PUBG 1320 UC",
7 "price": "4743.24"
8 },
9 {
10 "name": "PUBG 1800 UC",
11 "price": "5929.05"
12 },
13 {
14 "name": "PUBG 325 UC",
15 "price": "1185.81"
16 }
17 ]
18}استجابات الأخطاء
400 - JSON غير صالح
json
{
"status": "error",
"message": "Invalid JSON"
}400 - encrypted_sk مطلوب
json
{
"status": "error",
"message": "encrypted_sk is required"
}400 - مفتاح سري غير صالح
json
{
"status": "error",
"message": "Invalid secret key"
}400 - صيغة المفتاح السري غير صحيحة
json
{
"status": "error",
"message": "Invalid secret key format"
}500 - خطأ في الواجهة الخارجية
json
{
"status": "error",
"message": "Error fetching products: [error details]"
}حقول الاستجابة
| الحقل | النوع | الوصف |
|---|---|---|
status | string | حالة الاستجابة: "success" أو "error" |
count | integer | إجمالي عدد المنتجات المتاحة المُعادة |
products | array | مصفوفة كائنات المنتجات |
products[].name | string | اسم المنتج |
products[].price | string | سعر المنتج بالدينار الجزائري |
الميزات
المصادقة: التحقق من صحة مفاتيح Stellar السرية
دعم التشفير: يتعامل مع المفاتيح النصية والمشفرة بـ RSA
تصفية البحث: معامل بحث اختياري لتصفية المنتجات
تصفية التوفر: يُعيد فقط المنتجات المتاحة
استجابة مبسطة: يُعيد فقط المعلومات الأساسية (الاسم والسعر)
تكامل API خارجي: يجلب البيانات من sofizpay.dz
- تُعاد جميع المنتجات المتاحة إذا لم يتم تحديد كلمة بحث
- تُعاد الأسعار كنصوص لتجنب مشاكل دقة الأرقام العشرية
- يتم تضمين المنتجات ذات is_available: true فقط
- النقطة معفاة من CSRF لسهولة تكامل العملاء