شراء السلع والخدمات بدون تسجيل المستخدم

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

• المستخدم غير مصرح له.
• يقوم المستخدم بملء نموذج بالبيانات (على سبيل المثال، guest_orders).
• يختار المنتجات (يمكنك إعداد قائمة مسبقًا).
• يتم تقديم الطلب للمستخدم guest_user.

✅ ما تحتاجه:

• عنوان PROJECT_URL و APP_TOKEN صالحين للمصادقة مع واجهة برمجة التطبيقات OneEntry.
• علامة نموذج الطلب الضيف، على سبيل المثال guest_orders
• قائمة productId والكمية

📌 مهم:

• يجب أن تتطابق حقول النموذج (العلامة، النوع) مع إعدادات النموذج في لوحة الإدارة.
• إذا كنت بحاجة إلى إرسال إشعار حول الطلب، يمكنك استخدام الأحداث.
• نحن لا نتعامل مع الأخطاء في هذه الأمثلة.
• يمكنك التعامل مع الأخطاء في 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 { AuthProvider, Orders, Payments, Forms } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. نشكل مصفوفة بالحقول المطلوبة لمصادقة المستخدم

الحقول المطلوبة: البريد الإلكتروني = "email_reg"، كلمة المرور = "password_reg"

النتيجة:

[
  {
    "marker": "email_reg",
    "value": "guest@onnentry.cloud"
  },
  {
    "marker": "password_reg",
    "value": "12345121334"
  }
]

4. تسجيل الدخول كمستخدم ضيف باستخدام AuthProvider.auth() لتقديم طلب

البيانات:

[
  {
    "marker": "email_reg",
    "value": "guest@onnentry.cloud"
  },
  {
    "marker": "password_reg",
    "value": "12345121334"
  }
]

مثال:

const user = await AuthProvider.auth("email", {authData: authData});

النتيجة:

{
  "userIdentifier": "guest@onnentry.cloud",
  "authProviderIdentifier": "email",
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR...pZCI6MTYsImF1dGhQ"
  "refreshToken": "1745494429101-...-2834edf8"
}

5. توليد البيانات التي يتم الحصول عليها عادة من نموذج الواجهة الأمامية

مثال:

{
  "formIdentifier": "guest_order",
  "paymentAccountIdentifier": "cash",
  "formData": {
    "en_US": [
      {
        "marker": "guest_name",
        "type": "string",
        "value": "Christina Thomas"
      },
      {
        "marker": "guest_phone",
        "type": "string",
        "value": "+18005000500"
      },
      {
        "marker": "guest_email",
        "type": "string",
        "value": "guest@yourmail.com"
      }
    ]
  },
  "products": [
    {
      "productId": 10,
      "quantity": 1
    }
  ]
}

6. إنشاء طلب ضيف باستخدام Orders.createOrder()

مثال:

const orderData = await Orders.createOrder("guest_orders", body);

7. إنشاء جلسة دفع باستخدام Payments.createSession()

مثال:

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

النتيجة:

{
  "id": 47,
  "createdDate": "2025-04-30T21:47:45.344Z",
  "updatedDate": "2025-04-30T21:47:45.344Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 90,
  "paymentUrl": null
}

8. الحصول على كائن جلسة دفع واحدة بواسطة معرف الطلب باستخدام Payments.getSessionByOrderId()

مثال:

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

النتيجة:

{
  "id": 47,
  "createdDate": "2025-04-30T21:47:45.344Z",
  "updatedDate": "2025-04-30T21:47:45.344Z",
  "type": "session",
  "status": "waiting",
  "paymentAccountId": 1,
  "orderId": 90,
  "paymentUrl": null
}

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

// 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 { AuthProvider, Orders } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

// 3. نشكل مصفوفة بالحقول المطلوبة لمصادقة المستخدم
const authData = [
  {
    // علامة البريد الإلكتروني لنموذج التسجيل
    marker: 'email_reg',
    value: 'guest@onnentry.cloud',
  },
  {
    // علامة كلمة المرور لنموذج التسجيل
    marker: 'password_reg',
    value: '12345121334',
  },
];

// 4. تسجيل الدخول كمستخدم ضيف لتقديم طلب
const user = await AuthProvider.auth('email', {
  authData: authData,
});

// 5. نقوم بتوليد البيانات التي يتم الحصول عليها عادة من الواجهة الأمامية
const guestFormData = [
  {
    marker: 'guest_name',
    type: 'string',
    value: 'Christina Thomas',
  },
  {
    marker: 'guest_phone',
    type: 'string',
    value: '+18005000500',
  },
  {
    marker: 'guest_email',
    type: 'string',
    value: 'guest@yourmail.com',
  },
];
const productsData = [
  {
    productId: 1,
    quantity: 1,
  },
];
const body: IOrderData = {
  formIdentifier: 'guest_order',
  // paymentAccountIdentifier: cash | stripe
  paymentAccountIdentifier: 'cash',
  formData: guestFormData,
  products: productsData,
};

// 6. إنشاء طلب ضيف
const order = await Orders.createOrder('guest_orders', body);

// 7. إنشاء جلسة دفع
const paymentSession = await Payments.createSession(
  order.id,
  'session',
  false,
);

// 8. تحديث الجلسة بواسطة id
const updateSession = await Payments.updateSessionById(paymentSession.id, {
  status: 'guest_completed',
  paymentUrl: paymentSession.paymentUrl,
});

// 9. الحصول على كائن جلسة دفع واحدة بواسطة معرف الطلب
const sessionByOrderId = await Payments.getSessionByOrderId(order.id);
console.log(sessionByOrderId);