更详细的注册表单

运行机制

用户注册过程中，将请求以下主要字段：

• 使用API调用时：
  • 用户名
  • 电子邮箱
  • 密码
  用户名和电子邮箱字段的值应相同。
• 使用任意版本的登录管理器小组件时：
  • 电子邮箱
  • 密码

如需要，还可以向用户请求额外字段。

适用对象

已集成登录管理器的合作伙伴。

如何获取

详细用户表单中可用的字段取决于使用的登录管理器集成方法和用户数据存储方法。要设置该表单，请选择集成和存储类型，并按照说明进行操作。

通过API调用集成

如果选择通过API调用进行集成：

1. 联系您的帐户经理并向其发送字段列表。对于每个字段，指定：
   1. 名称；
   2. 类型；
   3. 是否为必需；
   4. 请求注册的API调用时用到的参数名称。

默认字段选项：

2. 在Register new user请求中，将必需字段传入fields参数。

请求示例：

POST https://login.xsolla.com/api/user?login_url=https://example.com&projectId={projectId} HTTP/1.1
Content-Type: application/json

{
  "username": "john-email@email.com",
  "password": "123456",
  "email": "john-email@email.com",
  "fields": {
     "nickname": "John",
     "country-name": "US",
     "bday": "1997-07-16"
  }
}

curl --request POST \
  --url 'https://login.xsolla.com/api/user?login_url=https%3A%2F%2Fexample.com&projectId=projectId' \
  --header 'content-type: application/json' \
  --data '{"username":"john-email@email.com","password":"123456","email":"john-email@email.com","fields":{"nickname":"John","country-name":"US","bday":"1997-07-16"}}'

通过登录管理器小组件集成

如果通过任意版本的登录管理器小组件进行集成，请联系您的帐户经理并向其发送字段列表。对于每个字段，请指定其名称以及是否为必需字段。

默认字段选项：

• 用户名（始终必需）
• 名字
• 姓氏
• 昵称
• 出生日期
• 性别
• 平台
• 国家/地区
• 订阅电子简讯

艾克索拉存储

如果使用艾克索拉存储，仅可使用列出的字段。字段值存储在艾克索拉侧。

PlayFab存储

如果使用PlayFab存储，额外字段将作为用户数据存储在您的Title PlayFab中。

除列出的字段外，可传入包含以下信息的其他字段：

• 名称
• 类型：
  • string
  • date
  • select—列表中的一个选项
  • multi-select—列表中的多个选项
• 是否为必需

可通过PlayFab API或在您的Playfab帐户中获取用户数据：

1. 前往Players，然后单击用户ID。

2. 选择Player Data (Title)选项卡。

自定义存储

如果使用自定义存储，将在注册请求中发送额外字段至新用户URL。

除列出的字段外，可传入包含以下信息的其他字段：

• 名称
• 类型：
  • string
  • date
  • select—列表中的一个选项
  • multi-select—列表中的多个选项
• 是否为必需

示例

设置了以下字段：

• 昵称
• 国家/地区
• 类型为multi-select，可选值为windows、mac os、linux的自定义字段platform

POST https://your.hostname/new_user_url.path HTTP/1.1
Content-Type: application/json
Authorization: Bearer {JWT}

{
  "email": "john@gmail.com",
  "password": "123456",
  "country-name": "DE",
  "nickname": "JohnSnow",
  "platform": ["windows", "mac os"]
}

curl --request POST \
  --url 'https://your.hostname/new_user_url.path' \
  --header 'authorization: bearer_JWT' \
  --header 'content-type: application/json' \
  --data '{"email":"john@gmail.com","password":"123456","country-name":"DE","nickname":"JohnSnow","platform":["windows","mac os"]}'