تحديث سمات المستخدم مثل رقم الهاتف

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

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

• يقوم المستخدم بتسجيل الدخول باستخدام اسم المستخدم وكلمة المرور
• يدخل رقم هاتف جديد في حقل الهاتف
• يحفظ بيانات المستخدم في منصة OneEntry

✅ ما تحتاجه:

• عنوان PROJECT_URL و APP_TOKEN صالحين للمصادقة مع واجهة برمجة التطبيقات OneEntry.
• نموذج تسجيل مع علامة "reg"
• حقول النموذج (السمات) مع علامات "email_reg"، "password_reg"، "name_reg"، "phone_reg"
• بريد إلكتروني/رقم هاتف صالح لاستلام رمز التفعيل

📌 مهم:

• لا تتضمن هذه الأمثلة معالجة الأخطاء.
• يمكنك إدارة الأخطاء باستخدام كتلة try-catch أو من خلال استخدام بناء مثل await Promise.catch((error) => error).
• تأكد من أن formIdentifier المستخدم في طريقة updateUser() يتطابق مع ما تم تكوينه في مشروع 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 { Forms, FormData } = defineOneEntry(PROJECT_URL, {
  token: APP_TOKEN,
});

3. تشكيل authData ومصادقة المستخدم باستخدام 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. الحصول على المستخدم لتوليد نموذج الواجهة الأمامية باستخدام Users.getUser()

مثال:

const user = await Users.getUser();

النتيجة:

{
  "id": 33,
  "identifier": "your-user@email.com",
  "authProviderIdentifier": "email",
  "formData": [
    {
      "marker": "name_reg",
      "type": "string",
      "value": "UserName"
    },
    {
      "marker": "email_notification_reg",
      "type": "string",
      "value": "your-user@email.com"
    },
    {
      "marker": "phone_reg",
      "type": "string",
      "value": "+19258382551"
    }
  ],
  "formIdentifier": "reg",
  "groups": [
    1
  ],
  "state": {},
  "moduleFormConfigs": []
}

5. تحديث المستخدم باستخدام Users.updateUser()

البيانات:

{
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "password_reg",
      "value": "123456"
    }
  ],
  "formData": {
    "en_US": [
      {
        "marker": "name_reg",
        "type": "string",
        "value": "UserName"
      },
      {
        "marker": "email_notification_reg",
        "type": "string",
        "value": "your-user@email.com"
      },
      {
        "marker": "phone_reg",
        "type": "string",
        "value": "+19258382551"
      }
    ]
  },
  "notificationData": {
    "email": "your-user@email.com",
    "phonePush": [
      "+19258382551"
    ],
    "phoneSMS": "+19258382551"
  },
  "langCode": "en_US"
}

مثال:

const updateUser = await Users.updateUser(body);

النتيجة:

true

6. الحصول على المستخدم باستخدام Users.getUser()

مثال:

const userData = await Users.getUser();

النتيجة:

{
  "id": 33,
  "identifier": "your-user@email.com",
  "authProviderIdentifier": "email",
  "formData": [
    {
      "marker": "name_reg",
      "type": "string",
      "value": "UserName"
    },
    {
      "marker": "email_notification_reg",
      "type": "string",
      "value": "your-user@email.com"
    },
    {
      "marker": "phone_reg",
      "type": "string",
      "value": "+19258382551"
    }
  ],
  "formIdentifier": "reg",
  "groups": [
    1
  ],
  "state": {},
  "moduleFormConfigs": []
}

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

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

// 3. تشكيل authData ومصادقة المستخدم باستخدام AuthProvider.auth()
const emailReg = 'your-user@email.com';
const authData = [
  {
    marker: 'email_reg',
    value: emailReg,
  },
  {
    marker: 'password_reg',
    value: '123456',
  },
];
const authResponse = await AuthProvider.auth('email', {
  authData,
});

// 4. الحصول على المستخدم لتوليد نموذج الواجهة الأمامية باستخدام Users.getUser()
const user = await Users.getUser();

// 5. تحديث المستخدم باستخدام Users.updateUser()
const newPhone = '+79258382551';
const body = {
  formIdentifier: 'reg',
  authData: [
    {
      marker: 'password_reg',
      value: '123456',
    },
  ],
  formData: [
    ...user.formData.filter(
      (d: { marker: string }) => d.marker !== 'phone_reg',
    ),
    {
      marker: 'phone_reg',
      type: 'string',
      value: newPhone,
    },
  ],
  notificationData: {
    email: emailReg,
    phonePush: [newPhone],
    phoneSMS: newPhone,
  },
};
const updateUser = await Users.updateUser(body);
console.log(updateUser);

// 6. الحصول على المستخدم باستخدام Users.getUser()
const userData = await Users.getUser();
console.log(userData);