انتقل إلى المحتوى الرئيسي

طلب تذاكر الفعاليات

يُنشئ طلبًا لتذاكر الفعاليات.

ما يفعله هذا المثال:

  • يسجّل دخول المستخدم
  • يحصل على نموذج التذاكر ويوسّع الجدول الزمني إلى فترات زمنية
  • يُنشئ طلبًا للتذكرة المختارة وجلسة دفع له

المتطلبات المسبقة:

  • قيمتا PROJECT_URL وAPP_TOKEN صالحتان لـ OneEntry API.
  • مستخدم مسجل لتسجيل الدخول به
  • نموذج بالعلامة "tickets_form" والحقلين "schedule" و"tickets"
  • مخزن طلبات مهيأ بالعلامة "tickets"

ملاحظات:

  • تعالج الأمثلة الأخطاء بالحد الأدنى: فهي ترمي استثناءً عندما يُرجع الاستدعاء كائن خطأ.
  • افتراضيًا (isShell: true) يُعيد SDK كائن خطأ بدلًا من رمي استثناء، لذا تحقق من النتيجة، مثل 'statusCode' in result. مع isShell: false يرمي استثناءً، وتعالج الأخطاء باستخدام try/catch. راجع الأخطاء.

وثائق المنصة:

مرجع SDK:

جربها مباشرة​

شغّل هذا المثال في بيئة JS SDK التجريبية. اربط Project URL وApp Token عند الزيارة الأولى، ثم افتح:

السيناريو​

1. استورد defineOneEntry وعرّف PROJECT_URL وAPP_TOKEN​

import { defineOneEntry } from 'oneentry';

const PROJECT_URL = 'https://your-project.oneentry.cloud';
const APP_TOKEN = 'your-app-token';

2. أنشئ عميل API باستخدام defineOneEntry()​

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

3. صادِق على المستخدم باستخدام AuthProvider.auth()​

const authData = [
  { marker: 'email_reg', value: 'your-email' },
  { marker: 'password_reg', value: 'your-password' },
];
const authResponse = await AuthProvider.auth('email', { authData });

if ('statusCode' in authResponse) {
  throw new Error(authResponse.message);
}

console.log(authResponse);
النتيجة:
{
  "userIdentifier": "john@example.com",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ",
  "refreshToken": "1745494429101-...-2834edf8"
}

4. احصل على النموذج من منصة OneEntry باستخدام Forms.getFormByMarker() لبنائه في الواجهة الأمامية​

const form = await Forms.getFormByMarker('tickets_form');

if ('statusCode' in form) {
  throw new Error(form.message);
}
console.log(form);
النتيجة:
{
  "id": 9,
  "attributeSetId": 12,
  "type": "order",
  "localizeInfos": {
    "title": "Tickets",
    "titleForSite": "Tickets",
    "successMessage": "",
    "unsuccessMessage": "",
    "urlAddress": "",
    "database": "0",
    "script": "0"
  },
  "version": 6,
  "position": 1,
  "identifier": "tickets_form",
  "processingType": "script",
  "templateId": null,
  "attributes": [
    {
      "type": "timeInterval",
      "marker": "schedule",
      "position": 1,
      "settings": {},
      "isVisible": true,
      "listTitles": [],
      "validators": {},
      "initialValue": null,
      "localizeInfos": {
        "title": "Schedule",
        "intervals": [
          {
            "id": "ef9cf848-7373-4b81-98bd-7ad33aa951e2",
            "range": [
              "2025-04-26T21:00:00.000Z",
              "2025-04-26T21:00:00.000Z"
            ],
            "external": [],
            "intervals": [
              {
                "id": "f2042e47-c650-4fc6-ae1c-efdb109b450f",
                "end": {
                  "hours": 21,
                  "minutes": 30
                },
                "start": {
                  "hours": 16,
                  "minutes": 30
                },
                "period": 90
              }
            ],
            "inEveryWeek": true,
            "inEveryMonth": true
          }
        ]
      },
      "additionalFields": {}
    },
    {
      "type": "entity",
      "marker": "tickets",
      "position": 2,
      "settings": {},
      "isVisible": true,
      "listTitles": [
        {
          "title": "Tickets",
          "value": {
            "id": 8,
            "depth": 0,
            "isPinned": false,
            "parentId": null,
            "position": "0|hzzzz3:"
          }
        },
        {
          "title": "Bronze",
          "value": {
            "id": "p-8-10",
            "depth": 1,
            "isPinned": false,
            "parentId": 8,
            "position": 1,
            "selected": true
          }
        },
        {
          "title": "Silver",
          "value": {
            "id": "p-8-11",
            "depth": 1,
            "isPinned": false,
            "parentId": 8,
            "position": 2,
            "selected": true
          }
        },
        {
          "title": "Gold",
          "value": {
            "id": "p-8-12",
            "depth": 1,
            "isPinned": false,
            "parentId": 8,
            "position": 3,
            "selected": true
          }
        }
      ],
      "validators": {
        "requiredValidator": {
          "strict": true
        }
      },
      "initialValue": null,
      "localizeInfos": {
        "title": "Tickets"
      },
      "additionalFields": {}
    }
  ],
  "total": "1",
  "moduleFormConfigs": []
}

تحمل السمة schedule قاعدة تكرار مضغوطة، لا قائمة فترات زمنية. حوّلها إلى أزواج [start, end] فعلية للتواريخ التي تعرضها باستخدام expandTimeIntervals؛ راجع الفترات الزمنية:

import { expandTimeIntervals } from 'oneentry';

const field = form.attributes.find((a) => a.marker === 'schedule');

const slots = (field?.localizeInfos.intervals ?? []).flatMap((schedule) =>
  expandTimeIntervals(schedule, { from: '2025-04-01', to: '2025-04-30' }),
);

5. أنشئ طلبًا في مخزن الطلبات باستخدام Orders.createOrder()​

const body = {
  formIdentifier: 'tickets_form',
  paymentAccountIdentifier: 'cash',
  formData: [{ type: 'entity', marker: 'tickets', value: ['p-8-10'] }],
  products: [{ productId: 10, quantity: 1 }],
};
const order = await Orders.createOrder('tickets', body);

if ('statusCode' in order) {
  throw new Error(order.message);
}
النتيجة:
{
  "id": 123,
  "formIdentifier": "tickets_form",
  "paymentAccountIdentifier": "cash",
  "formData": [
    {
      "type": "entity",
      "marker": "tickets",
      "value": [
        "p-8-10"
      ]
    }
  ],
  "products": [
    {
      "productId": 10,
      "quantity": 1
    }
  ],
  "currency": "USD",
  "totalSum": 100,
  "bonusApplied": 0,
  "totalDue": 100,
  "discountConfig": {
    "orderDiscounts": [],
    "productDiscounts": [],
    "coupon": null,
    "settings": {
      "allowStacking": false,
      "maxDiscountValue": null,
      "allowGiftStacking": false,
      "maxBonusPaymentPercent": null,
      "minBonusAmount": null,
      "minOrderAmountForBonus": null,
      "giftRefundPolicy": "KEEP_GIFT"
    },
    "additionalDiscountsMarkers": [],
    "totalRaw": 100,
    "totalSumWithDiscount": 100,
    "excludedGiftProductIds": [],
    "bonus": {
      "availableBalance": 0,
      "maxBonusDiscount": 0,
      "minBonusAmount": null,
      "minOrderAmountForBonus": null,
      "bonusApplied": 0
    },
    "bonusApplied": 0,
    "totalDue": 100
  },
  "statusIdentifier": "new",
  "statusLocalizeInfos": {
    "title": "new"
  },
  "createdDate": "2026-06-06T11:54:31.545Z"
}

6. أنشئ جلسة دفع باستخدام Payments.createSession()​

const paymentSession = await Payments.createSession(order.id, 'session', false);

if ('statusCode' in paymentSession) {
  throw new Error(paymentSession.message);
}

console.log(paymentSession);
النتيجة:
{
  "id": 71,
  "createdDate": "2026-06-06T11:54:31.857Z",
  "updatedDate": "2026-06-06T11:54:31.857Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 123,
  "amount": null,
  "paymentUrl": null
}

7. احصل على جلسة الدفع بمعرّف الطلب باستخدام Payments.getSessionByOrderId()​

const sessionByOrderId = await Payments.getSessionByOrderId(order.id);

if ('statusCode' in sessionByOrderId) {
  throw new Error(sessionByOrderId.message);
}

console.log(sessionByOrderId);
النتيجة:
[
  {
    "id": 71,
    "createdDate": "2026-06-06T11:54:31.857Z",
    "updatedDate": "2026-06-06T11:54:31.857Z",
    "type": "session",
    "status": "waiting",
    "paymentAccountId": 1,
    "orderId": 123,
    "amount": null,
    "paymentUrl": null
  }
]

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

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

const PROJECT_URL = 'https://your-project.oneentry.cloud';
const APP_TOKEN = 'your-app-token';

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

// 3. Sign in
const authData = [
  { marker: 'email_reg', value: 'your-email' },
  { marker: 'password_reg', value: 'your-password' },
];
const authResponse = await AuthProvider.auth('email', { authData });

if ('statusCode' in authResponse) {
  throw new Error(authResponse.message);
}

console.log(authResponse);

// 4. Get the form to build it on the frontend
const form = await Forms.getFormByMarker('tickets_form');

if ('statusCode' in form) {
  throw new Error(form.message);
}
console.log(form);

// 5. Create an order in the order storage
const body = {
  formIdentifier: 'tickets_form',
  paymentAccountIdentifier: 'cash',
  formData: [{ type: 'entity', marker: 'tickets', value: ['p-8-10'] }],
  products: [{ productId: 10, quantity: 1 }],
};
const order = await Orders.createOrder('tickets', body);

if ('statusCode' in order) {
  throw new Error(order.message);
}

// 6. Create a payment session
const paymentSession = await Payments.createSession(order.id, 'session', false);

if ('statusCode' in paymentSession) {
  throw new Error(paymentSession.message);
}

console.log(paymentSession);

// 7. Get the payment session by order ID
const sessionByOrderId = await Payments.getSessionByOrderId(order.id);

if ('statusCode' in sessionByOrderId) {
  throw new Error(sessionByOrderId.message);
}

console.log(sessionByOrderId);