الاشتراك في المحتوى

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

✅ هدف السيناريو:

• فقط المستخدمون الذين لديهم اشتراك يمكنهم الوصول إلى المحتوى
• يتم التحقق بناءً على الطلبات، المستخدم.
• أولئك الذين ليس لديهم تفويض أو لم يشتروا سيحصلون على عرض للاشتراك.

✅ ما تحتاجه:

• عنوان PROJECT_URL و APP_TOKEN صالحين للمصادقة مع واجهة برمجة التطبيقات OneEntry.

📌 مهم:

• لا نتعامل مع الأخطاء في هذه الأمثلة.
• يمكنك التعامل مع الأخطاء في trycatch أو في بناء مثل "await Promise.catch((error) => error)"

السيناريو

1. استيراد oneEntry وتعريف url و token

مثال:

import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

2. إنشاء عميل API باستخدام دالة defineOneEntry()

مثال:

const { Users, Orders, Pages, Payments, AuthProvider, Forms } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. إعداد البيانات لمصادقة المستخدم

مثال:

[
  {
    "marker": "email_reg",
    "value": "your-user@email.com"
  },
  {
    "marker": "password_reg",
    "value": "123456"
  }
]

4. المصادقة والحصول على بيانات المستخدم AuthProvider.auth()

مثال:

const authResponse = await AuthProvider.auth('email', {
  authData,
});

النتيجة:

{
  "userIdentifier": "your-user@email.com",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
  "refreshToken": "1745494429101-...-2834edf8"
}

5. نحصل على قائمة طلبات المستخدم باستخدام Orders.getAllOrdersByMarker()

مثال:

const orders = await Orders.getAllOrdersByMarker('subscriptions');

النتيجة:

{
  "items": [
    {
      "id": 91,
      "storageId": 2,
      "createdDate": "2025-04-30T21:48:40.628Z",
      "statusIdentifier": "active",
      "formIdentifier": "subscription",
      "formData": [
        {
          "type": "date",
          "marker": "expired_date",
          "value": {
            "fullDate": "2025-05-07T00:00:00.000Z",
            "formattedValue": "07-05-2025 00:00",
            "formatString": "DD-MM-YYYY HH:mm"
          }
        },
        {
          "type": "list",
          "marker": "subscription_time",
          "value": [
            {
              "title": "1 month",
              "value": "1",
              "extended": {
                "type": "real",
                "value": "100"
              }
            }
          ]
        }
      ],
      "attributeSetIdentifier": "subscriptions",
      "totalSum": "100.00",
      "currency": "",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 3,
          "title": "1 month",
          "sku": "",
          "previewImage": null,
          "price": 100,
          "quantity": 1
        }
      ],
      "isCompleted": false
    }
  ],
  "total": 1
}

6. التحقق من وجود اشتراك نشط

مثال:

const now = new Date();
const hasActiveSubscription = orders.items?.some(
  (order: any) =>
    new Date(
      order.formData.find(
        (d: { marker: string }) => d.marker === 'expired_date',
      ).value.fullDate,
    ) > now,
);

النتيجة:

true

7. إذا كان الاشتراك نشطًا، نقدم الوصول، وإلا نقوم بإنشاء طلب وتوليد الدفع

مثال:

let content = null;
if (hasActiveSubscription) {
  // ✅ الاشتراك نشط → عرض المحتوى
  content = await Pages.getPageByUrl('premium_page');
  console.log('🎉 تم فتح الوصول:', content);
} else {
  // ❌ لا يوجد اشتراك → إنشاء طلب وتوليد الدفع
  const body = {
    formIdentifier: 'subscription',
    paymentAccountIdentifier: 'cash',
    formData: [
      {
        type: 'date',
        marker: 'expired_date',
        value: {
          fullDate: '2025-05-07T00:00:00.000Z',
          formattedValue: '07-05-2025 00:00',
          formatString: 'DD-MM-YYYY HH:mm',
        },
      },
      {
        type: 'list',
        marker: 'subscription_time',
        value: [
          {
            title: '1 month',
            value: '1',
            extended: {
              type: 'real',
              value: '100',
            },
          },
        ],
      },
    ],
    products: [
      {
        productId: 3,
        quantity: 1,
      },
    ],
  };
  const order = await Orders.createOrder('subscriptions', body);
  const payment = await Payments.createSession(order.id, 'session', false);
  // console.log('💸 تابع الدفع للاشتراك الخاص بك:', payment)
}

النتيجة:

{
  "id": 7,
  "parentId": null,
  "pageUrl": "premium_page",
  "depth": 0,
  "localizeInfos": {
    "title": "الصفحة المتميزة",
    "menuTitle": "الصفحة المتميزة",
    "htmlContent": "",
    "plainContent": ""
  },
  "isVisible": true,
  "forms": [],
  "blocks": [],
  "type": "common_page",
  "templateIdentifier": null,
  "attributeSetIdentifier": null,
  "attributeValues": {},
  "isSync": false
}

المثال النهائي

// 1. استيراد oneEntry وتعريف PROJECT_URL و APP_TOKEN
import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'your-project-url';
const APP_TOKEN = 'your-app-token';

// 2. إنشاء عميل API 
const { Users, Orders, Pages, Payments, AuthProvider, Forms } =
  defineOneEntry(PROJECT_URL, {
    token: APP_TOKEN,
  });

// 3. إعداد البيانات لمصادقة المستخدم
// const form = await Forms.getFormByMarker('subscription');
// expired_date - تاريخ
// subscription_time - قائمة

const authData = [
  {
    marker: 'email_reg',
    value: 'your-user@email.com',
  },
  {
    marker: 'password_reg',
    value: '123456',
  },
];

// 4. المصادقة والحصول على بيانات المستخدم
const authResponse = await AuthProvider.auth('email', {
  authData,
});
const user = await Users.getUser();

// 5. نحصل على قائمة طلبات المستخدم
const orders = await Orders.getAllOrdersByMarker('subscriptions');

// 6. التحقق من وجود اشتراك نشط
const now = new Date();
const hasActiveSubscription = orders.items?.some(
  (order: any) =>
    new Date(
      order.formData.find(
        (d: { marker: string }) => d.marker === 'expired_date',
      ).value.fullDate,
    ) > now,
);

// 7. إذا كان الاشتراك نشطًا، نقدم الوصول، وإلا نقوم بإنشاء طلب وتوليد الدفع
let content = null;
if (hasActiveSubscription) {
  // ✅ الاشتراك نشط → عرض المحتوى
  content = await Pages.getPageByUrl('premium_page');
  console.log('🎉 تم فتح الوصول:', content);
} else {
  // ❌ لا يوجد اشتراك → إنشاء طلب وتوليد الدفع
  const body = {
    formIdentifier: 'subscription',
    paymentAccountIdentifier: 'cash',
    formData: [
      {
        type: 'date',
        marker: 'expired_date',
        value: {
          fullDate: '2025-05-07T00:00:00.000Z',
          formattedValue: '07-05-2025 00:00',
          formatString: 'DD-MM-YYYY HH:mm',
        },
      },
      {
        type: 'list',
        marker: 'subscription_time',
        value: [
          {
            title: '1 month',
            value: '1',
            extended: {
              type: 'real',
              value: '100',
            },
          },
        ],
      },
    ],
    products: [
      {
        productId: 3,
        quantity: 1,
      },
    ],
  };
  const order = await Orders.createOrder('subscriptions', body);
  const payment = await Payments.createSession(order.id, 'session', false);
  console.log('💸 تابع الدفع للاشتراك الخاص بك:', payment);
}