تاريخ طلبات المستخدم

في هذا المثال، نوضح كيفية استرجاع وعرض تاريخ طلبات المستخدم باستخدام واجهة برمجة التطبيقات OneEntry.

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

• يقوم المستخدم بتسجيل الدخول باستخدام بيانات اعتماده
• نحصل على تاريخ طلبات المستخدم

✅ ما تحتاجه:

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

📌 مهم:

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

السيناريو

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

3. المصادقة باستخدام AuthProvider.auth()

البيانات:

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

مثال:

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

النتيجة:

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

4. الحصول على جميع طلبات المستخدم بواسطة علامة تخزين الطلب باستخدام Orders.getAllOrdersByMarker()

مثال:

const allOrders = await Orders.getAllOrdersByMarker('orders', 'en_US', 0, 30);

النتيجة:

{
  "items": [
    {
      "id": 98,
      "storageId": 1,
      "createdDate": "2025-10-23T13:42:45.421Z",
      "statusIdentifier": "upcoming",
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "Christina Thomas"
        }
      ],
      "attributeSetIdentifier": "order",
      "totalSum": "340.00",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 14,
          "title": "Green ball",
          "sku": null,
          "previewImage": [],
          "price": 340,
          "quantity": 1
        }
      ],
      "isCompleted": false
    },
    {
      "id": 97,
      "storageId": 1,
      "createdDate": "2025-08-29T17:33:30.141Z",
      "statusIdentifier": "upcoming",
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "Christina Thomas"
        }
      ],
      "attributeSetIdentifier": "order",
      "totalSum": "340.00",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 14,
          "title": "Green ball",
          "sku": null,
          "previewImage": [],
          "price": 340,
          "quantity": 1
        }
      ],
      "isCompleted": false
    },
    {
      "id": 96,
      "storageId": 1,
      "createdDate": "2025-08-29T17:32:53.278Z",
      "statusIdentifier": "upcoming",
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "Christina Thomas"
        }
      ],
      "attributeSetIdentifier": "order",
      "totalSum": "340.00",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 14,
          "title": "Green ball",
          "sku": null,
          "previewImage": [],
          "price": 340,
          "quantity": 1
        }
      ],
      "isCompleted": false
    },
    {
      "id": 93,
      "storageId": 1,
      "createdDate": "2025-08-28T21:39:04.945Z",
      "statusIdentifier": "upcoming",
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "Christina Thomas"
        }
      ],
      "attributeSetIdentifier": "order",
      "totalSum": "340.00",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 14,
          "title": "Green ball",
          "sku": null,
          "previewImage": [],
          "price": 340,
          "quantity": 1
        }
      ],
      "isCompleted": false
    },
    {
      "id": 89,
      "storageId": 1,
      "createdDate": "2025-04-30T20:15:29.254Z",
      "statusIdentifier": "upcoming",
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "Christina Thomas"
        }
      ],
      "attributeSetIdentifier": "order",
      "totalSum": "340.00",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 14,
          "title": "Green ball",
          "sku": null,
          "previewImage": [],
          "price": 340,
          "quantity": 1
        }
      ],
      "isCompleted": false
    },
    {
      "id": 88,
      "storageId": 1,
      "createdDate": "2025-04-30T20:15:12.616Z",
      "statusIdentifier": "upcoming",
      "formIdentifier": "order",
      "formData": [
        {
          "type": "string",
          "marker": "name",
          "value": "Christina Thomas"
        }
      ],
      "attributeSetIdentifier": "order",
      "totalSum": "340.00",
      "currency": "USD",
      "paymentAccountIdentifier": "cash",
      "paymentAccountLocalizeInfos": {
        "title": "Cash"
      },
      "products": [
        {
          "id": 14,
          "title": "Green ball",
          "sku": null,
          "previewImage": [],
          "price": 340,
          "quantity": 1
        }
      ],
      "isCompleted": false
    }
  ],
  "total": 6
}

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

// 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. المصادقة باستخدام AuthProvider.auth()
const authData = [
  {
    marker: 'email_reg',
    value: 'your-user@email.com',
  },
  {
    marker: 'password_reg',
    value: '123456',
  },
];
const authResponse = await AuthProvider.auth('email', {
  authData,
});

// 4. الحصول على جميع طلبات المستخدم بواسطة علامة تخزين الطلب باستخدام Orders.getAllOrdersByMarker()
const allOrders = await Orders.getAllOrdersByMarker('orders', 'en_US', 0, 30);
console.log(allOrders);