更详细的注册表单

运行机制

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

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

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

适用对象

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

如何获取

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

通过API调用集成

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

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

默认字段选项:

字段名称

类型参数名称
用户名(始终必需)stringusername
名字stringgiven-name
姓氏stringfamily-name
昵称stringnickname
出生日期date (YYYY-MM-DD)bday
性别enum (f or m)gender
国家/地区select (ISO 3166-1 alpha-2)country-name
订阅电子简讯booleanpromo_email_agreement

  1. Register new user请求中,将必需字段传入fields参数。

请求示例:

Copy
Full screen
Small screen
http
  • http
  • curl
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"}}'

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

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

默认字段选项:

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

Note
如果使用艾克索拉存储,平台字段不可用。

艾克索拉存储

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

PlayFab存储

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

列出的字段外,可传入包含以下信息的其他字段:

  • 名称
  • 类型:
    • string
    • date
    • select—列表中的一个选项
    • multi-select—列表中的多个选项
  • 是否为必需
通过API调用集成时,字段名称可以为任何值。对于selectmulti-select字段,请将这些字段的所有可选值发送给您的帐户经理。

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

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

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

自定义存储

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

列出的字段外,可传入包含以下信息的其他字段:

  • 名称
  • 类型:
    • string
    • date
    • select—列表中的一个选项
    • multi-select—列表中的多个选项
  • 是否为必需
通过API调用集成时,字段名称可以为任何值。对于selectmulti-select字段,请将这些字段的所有可选值发送给您的帐户经理。

示例

设置了以下字段:

  • 昵称
  • 国家/地区
  • 类型为multi-select,可选值为windowsmac oslinux的自定义字段platform
用户注册过程中,以下请求将发送至新用户URL

Copy
Full screen
Small screen
http
  • http
  • curl
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"]}'

本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。