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

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

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

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

✅ ما تحتاجه:

• عنوان URL صالح للمشروع PROJECT_URL ورمز التطبيق APP_TOKEN للمصادقة مع واجهة برمجة التطبيقات OneEntry.
• نموذج مع علامة "subscriptions"، السمات "expired_date" و "subscription_time" ونوع "نموذج الطلب"
• مستخدم مسجل

📌 مهم:

• هذه الأمثلة لا تتضمن معالجة الأخطاء.
• يمكنك إدارة الأخطاء باستخدام كتلة try-catch أو من خلال استخدام بناء مثل await Promise.catch((error) => error).

السيناريو

1. استيراد defineOneEntry من SDK وتحديد عنوان URL ورمز التوكن

مثال:

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": 95,
      "storageId": 2,
      "createdDate": "2025-08-29T13:32:04.663Z",
      "statusIdentifier": "active",
      "formIdentifier": "subscription",
      "formData": [
        {
          "marker": "expired_date",
          "type": "date",
          "value": {
            "fullDate": "2026-05-07T00:00:00.000Z",
            "formattedValue": "03-05-2026 00:00",
            "formatString": "DD-MM-YYYY HH:mm"
          }
        }
      ],
      "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
    },
    {
      "id": 94,
      "storageId": 2,
      "createdDate": "2025-08-29T13:29:30.068Z",
      "statusIdentifier": "active",
      "formIdentifier": "subscription",
      "formData": [
        {
          "marker": "expired_date",
          "type": "date",
          "value": {
            "fullDate": "2026-05-07T00:00:00.000Z",
            "formattedValue": "07-05-2026 00:00",
            "formatString": "DD-MM-YYYY HH:mm"
          }
        }
      ],
      "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
    },
    {
      "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": 3
}

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,
  "blocks": [],
  "type": "common_page",
  "templateIdentifier": null,
  "attributeSetIdentifier": null,
  "attributeValues": {},
  "moduleFormConfigs": [],
  "isSync": false
}

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

// 1. استيراد defineOneEntry من SDK وتحديد 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);
}