Nhảy đến nội dung

Đăng ký nội dung

Trong ví dụ này, chúng tôi sẽ trình bày cách quản lý quyền truy cập dựa trên đăng ký vào nội dung bằng cách sử dụng API OneEntry. Chúng tôi kiểm tra xem người dùng có đăng ký hoạt động hay không và cấp quyền truy cập vào nội dung cao cấp hoặc yêu cầu họ đăng ký.

✅ Mục đích của kịch bản:

  • Chỉ những người dùng có đăng ký mới có quyền truy cập vào nội dung
  • Việc kiểm tra dựa trên Đơn hàng, Người dùng.
  • Những người không được ủy quyền hoặc chưa mua sẽ nhận được đề nghị đăng ký.

✅ Những gì bạn cần:

  • Một PROJECT_URL và APP_TOKEN hợp lệ để xác thực với API OneEntry.
  • Biểu mẫu với dấu hiệu "subscriptions", thuộc tính "expired_date" và "subscription_time" và loại "Đơn hàng"
  • Người dùng đã đăng ký

📌 Quan trọng:

  • Những ví dụ này không bao gồm xử lý lỗi.
  • Bạn có thể quản lý lỗi bằng cách sử dụng khối try-catch hoặc bằng cách sử dụng một cấu trúc như await Promise.catch((error) => error).

Kịch bản​

1. Nhập defineOneEntry từ SDK và xác định url và token​

Ví dụ:

import { defineOneEntry } from 'oneentry';

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

2. Tạo một khách hàng API với hàm defineOneEntry()​

Ví dụ:

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

3. Chuẩn bị dữ liệu cho việc xác thực người dùng​

Ví dụ:

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

4. Xác thực và lấy dữ liệu người dùng AuthProvider.auth()​

Ví dụ:

const authResponse = await AuthProvider.auth('email', {
  authData,
});
Kết quả:
{
  "userIdentifier": "your-user@email.com",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
  "refreshToken": "1745494429101-...-2834edf8"
}

5. Chúng tôi lấy danh sách đơn hàng của người dùng với Orders.getAllOrdersByMarker()​

Ví dụ:

const orders = await Orders.getAllOrdersByMarker('subscriptions');
Kết quả:
{
  "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. Kiểm tra xem có đăng ký hoạt động hay không​

Ví dụ:

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,
);
Kết quả:
true

7. Nếu đăng ký đang hoạt động, chúng tôi cấp quyền truy cập, nếu không chúng tôi tạo một đơn hàng và tạo thanh toán​

Ví dụ:

let content = null;
if (hasActiveSubscription) {
  // ✅ Subscription active → show content
  content = await Pages.getPageByUrl('premium_page');
  console.log('🎉 Доступ открыт:', content);
} else {
  // ❌ No subscription → create an order and generate payment
  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('💸 Proceed to pay for your subscription:', payment)
}
Kết quả:
{
  "id": 7,
  "parentId": null,
  "pageUrl": "premium_page",
  "depth": 0,
  "localizeInfos": {
    "title": "Premium page",
    "menuTitle": "Premium page",
    "htmlContent": "",
    "plainContent": ""
  },
  "isVisible": true,
  "blocks": [],
  "type": "common_page",
  "templateIdentifier": null,
  "attributeSetIdentifier": null,
  "attributeValues": {},
  "moduleFormConfigs": [],
  "isSync": false
}

Ví dụ cuối cùng​

// 1. Import defineOneEntry from SDK and define PROJECT_URL and APP_TOKEN
import { defineOneEntry } from 'oneentry';

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

// 2. Creating an API client 
const { Users, Orders, Pages, Payments, AuthProvider, Forms } =
  defineOneEntry(PROJECT_URL, {
    token: APP_TOKEN,
  });

// 3. Preparing data for user authorization
const form = await Forms.getFormByMarker('subscription');
// expired_date - Date
// subscription_time - list

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

// 4. Authorization and obtaining user data
const authResponse = await AuthProvider.auth('email', {
  authData,
});
const user = await Users.getUser();

// 5. We get a list of user orders
const orders = await Orders.getAllOrdersByMarker('subscriptions');

// 6. Checking for an active subscription
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. If the subscription is active, we provide access, otherwise we create an order and generate payment
let content = null;
if (hasActiveSubscription) {
  // ✅ Subscription active → show content
  content = await Pages.getPageByUrl('premium_page');
  console.log('🎉 Access is open:', content);
} else {
  // ❌ No subscription → create an order and generate payment
  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('💸 Proceed to pay for your subscription:', payment);
}