更详细的注册表单
运行机制
用户注册过程中,将请求以下主要字段:
- 使用API调用时:
- 用户名
- 电子邮箱
- 密码
- 使用任意版本的登录管理器小组件时:
- 电子邮箱
- 密码
如需要,还可以向用户请求额外字段。
适用对象
已集成登录管理器的合作伙伴。
如何获取
详细用户表单中可用的字段取决于使用的登录管理器集成方法和用户数据存储方法。要设置该表单,请选择集成和存储类型,并按照说明进行操作。
通过Login API集成
如果选择通过Login API进行集成:
- 联系您的帐户经理并向其发送字段列表。对于每个字段,指定:
- 名称;
- 类型;
- 是否为必需;
- 请求注册的API调用时用到的参数名称。
默认字段选项:
字段名称 | 类型 | 参数名称 |
---|---|---|
用户名(始终必需) | string | username |
名字 | string | given-name |
姓氏 | string | family-name |
昵称 | string | nickname |
出生日期 | date (YYYY-MM-DD) | bday |
性别 | enum (f or m) | gender |
国家/地区 | select (ISO 3166-1 alpha-2) | country-name |
订阅电子简讯 | boolean | promo_email_agreement |
- 在
Register new user 请求中,将必需字段传入fields
参数。
请求示例:
Copy
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—列表中的多个选项
- 是否为必需
可通过
- 前往Players,然后单击用户ID。

- 选择Player Data (Title)选项卡。

自定义存储
如果使用自定义存储,将在注册请求中发送额外字段至新用户URL。
除列出的字段外,可传入包含以下信息的其他字段:
- 名称
- 类型:
- string
- date
- select—列表中的一个选项
- multi-select—列表中的多个选项
- 是否为必需
示例
设置了以下字段:
- 昵称
- 国家/地区
- 类型为multi-select,可选值为
windows
、mac os
、linux
的自定义字段platform
Copy
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"]}'
本文对您的有帮助吗?
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。为此页面评分
为此页面评分
不想回答
感谢您的反馈!
发现了错别字或其他内容错误? 请选择文本,然后按Ctrl+Enter。