Nhảy đến nội dung

signUp

Đăng ký người dùng (❗️Đối với các nhà cung cấp có kích hoạt người dùng, mã kích hoạt sẽ được gửi qua phương thức thông báo người dùng tương ứng)

Mô tả​

Phương thức nhận thân (body) như một tham số. Nó trả về một Promise mà khi hoàn thành sẽ trả về một đối tượng ISignUpEntity.

AuthProvider.signUp(

marker*, body*, formIdentifier*, langCode, formData

);

Sơ đồ tham số​

Sơ đồ

marker(required): string
Định danh văn bản của nhà cung cấp ủy quyền
ví dụ: "email"

body(required): ISignUpData
Thân yêu cầu
ví dụ:

{
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "example@oneentry.cloud"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  "formData": [
    {
      "marker": "last_name",
      "type": "string",
      "value": "Name"
    }
  ],
  "notificationData": {
    "email": "example@oneentry.cloud",
    "phonePush": [
      "+99999999999"
    ],
    "phoneSMS": "+99999999999"
  }
}

body.formIdentifier(required): string
Định danh cho mẫu đăng ký.
ví dụ: "reg"

body.langCode: string
Mã ngôn ngữ. Mặc định "en_US".

body.formData(required): IAuthFormData | IAuthFormData[]
Dữ liệu mẫu cho việc đăng ký, có thể là một đối tượng đơn hoặc một mảng các đối tượng.
ví dụ:

{
  "marker": "last_name",
  "type": "string",
  "value": "Name"
}

formData.marker(required): string
Một định danh duy nhất cho trường mẫu.
ví dụ: "email"

formData.type(required): string
Loại của trường mẫu, chẳng hạn như 'string', 'email', v.v.
ví dụ: "string"

formData.value(required): string
Giá trị được nhập vào trường mẫu.
ví dụ: "example@oneentry.cloud"

body.notificationData(required): Object
Một đối tượng chứa dữ liệu thông báo, bao gồm email, phonePush và phoneSMS.
ví dụ:

{
  "email": "example@oneentry.cloud", // Trường thông báo qua email. Bắt buộc.
  "phonePush": [
    "+99999999999"
  ],                                 // Trường thông báo qua push. Tùy chọn.
  "phoneSMS": "+99999999999"         // Trường thông báo qua SMS. Tùy chọn.
}

langCode: string
Mã ngôn ngữ. Mặc định: "en_US"
ví dụ: "en_US"

Ví dụ​

Ví dụ tối thiểu​


const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "example@oneentry.cloud"
    },
    {
      "marker": "password",
      "value":"12345"
    }
  ],
  "formData": [
    {
      "marker": "last_name",
      "type": "string",
      "value": "Name"
    }
  ],
  "notificationData": {
    "email": "example@oneentry.cloud",
    "phonePush": [
      "+99999999999"
    ],
    "phoneSMS": "+99999999999"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ với các thuộc tính của loại đơn giản formData "string", "integer", "float".​

const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  "formData": [
    {
      "marker": "last_name",
      "type": "string",
      "value": "Fyodor Ivanov"
    }
  ],
  "notificationData": {
    "email": "your-email@test.zone",
    "phonePush": [],
    "phoneSMS": "+19991234567"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ với các thuộc tính của loại "date", "dateTime", "time"​

const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  "formData": [
    {
      "marker": "birthday",
      "type": "date",
      "value": {
        "fullDate": "2024-05-07T21:02:00.000Z",
        "formattedValue": "08-05-2024 00:02",
        "formatString": "DD-MM-YYYY HH:mm"
      }
    }
  ],
  "notificationData": {
    "email": "your-email@test.zone",
    "phonePush": [],
    "phoneSMS": "+19991234567"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ với thuộc tính loại "text"​

Đối với giá trị trường văn bản, bạn có thể sử dụng một trong ba loại giá trị:

  • htmlValue - chuỗi HTML
  • plainValue - chuỗi
  • mdValue - chuỗi Markdown
const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  "formData": [
    {
      "marker": "about",
      "type": "text",
      "value": {
        "htmlValue": "<p>This is me</p>",
        // "plainValue": "",
        // "mdValue":  ""
      }
    }
  ],
  "notificationData": {
    "email": "your-email@test.zone",
    "phonePush": [],
    "phoneSMS": "+19991234567"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ với thuộc tính loại "textWithHeader"​

Đối với giá trị trường textWithHeader, bạn có thể sử dụng một trong ba loại giá trị:

  • htmlValue - chuỗi HTML
  • plainValue - chuỗi
  • mdValue - chuỗi Markdown
const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  "formData": [
    {
      "marker": "about",
      "type": "textWithHeader",
      "value": {
        "header": "Header",
        "htmlValue": "<p>This is me</p>",
        // "plainValue": "",
        // "mdValue":  ""
      }
    }
  ],
  "notificationData": {
    "email": "your-email@test.zone",
    "phonePush": [],
    "phoneSMS": "+19991234567"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ với các thuộc tính loại "image" và "groupOfImages"​

Nếu một đối tượng fileQuery được cung cấp trong đối tượng formData, tệp sẽ được tự động tải lên đám mây OneEntry thông qua SDK hoặc sử dụng File.uploadFile() Xem ví dụ

const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  formData: [
    {
      marker: "image",
      type: "image",
      value: [file],
      fileQuery: {
        type: "page",
        entity: "editor",
        id: 3492,
      },
    },
  ],
  "notificationData": {
    "email": "your-email@test.zone",
    "phonePush": [],
    "phoneSMS": "+19991234567"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ với thuộc tính loại "file"​

Nếu một đối tượng fileQuery được cung cấp trong đối tượng formData, tệp sẽ được tự động tải lên đám mây OneEntry thông qua SDK hoặc sử dụng File.uploadFile() Xem ví dụ

const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  formData: [
    {
      marker: "image",
      type: "image",
      value: [file],
      fileQuery: {
        type: "page",
        entity: "editor",
        id: 3492,
      },
    },
  ],
  "notificationData": {
    "email": "your-email@test.zone",
    "phonePush": [],
    "phoneSMS": "+19991234567"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ với các thuộc tính loại "radioButton" và "list"​

const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  formData: [
    {
      marker: "list",
      type: "list",
      value: ["1"],
    },
  ],
  "notificationData": {
    "email": "your-email@test.zone",
    "phonePush": [],
    "phoneSMS": "+19991234567"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ với thuộc tính loại "entity" (danh sách lồng nhau)​

const body = {
  "formIdentifier": "reg",
  "authData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "password",
      "value": "12345"
    }
  ],
  formData: [
    {
      marker: "entity",
      type: "entity",
      value: [2954, 2957],
    },
  ],
  "notificationData": {
    "email": "your-email@test.zone",
    "phonePush": [],
    "phoneSMS": "+19991234567"
  }
};

const response = await AuthProvider.signUp('email', body);

Ví dụ phản hồi​

{
  "createdDate": "2025-12-26T12:17:46.115Z",
  "deletedAt": null,
  "formData": [
    {
      "marker": "login",
      "value": "test"
    },
    {
      "marker": "f-name",
      "value": "Second name"
    }
  ],
  "id": 286,
  "identifier": "user_email@gmail.com",
  "isActive": false,
  "isDeleted": false,
  "locale": "en_US",
  "notificationData": {
    "email": "user_email@gmail.com"
  },
  "email": "user_email@gmail.com",
  "state": {},
  "updatedDate": "2025-12-26T12:17:46.115Z",
  "version": 0
}

Sơ đồ phản hồi​

Sơ đồ: ISignUpEntity

id: number
Định danh duy nhất của thực thể đăng ký.
ví dụ: 12345

updatedDate: string
Ngày mà thực thể đăng ký được cập nhật lần cuối.
ví dụ: "2023-10-01T12:00:00Z"

version: number
Số phiên bản của thực thể đăng ký.
ví dụ: 1

identifier: string
Một chuỗi duy nhất xác định thực thể đăng ký.
ví dụ: "signup_12345"

isActive: boolean
Chỉ ra liệu thực thể đăng ký có đang hoạt động hay không.
ví dụ: true

notificationData: object
Một đối tượng chứa dữ liệu thông báo, bao gồm email, phonePush và phoneSMS.
ví dụ:

{
  "email": "example@oneentry.cloud",
  "phonePush": [
    "+99999999999"
  ],
  "phoneSMS": "+99999999999"
}

locale: string
Mã ngôn ngữ hoặc địa phương liên quan đến thực thể đăng ký.
ví dụ: "en_US"