玩家注册

在 Hub 平台注册玩家账号。

接口信息

属性	值
路径	POST /papi/v1/player/register
认证	Agent Token (Bearer)
Content-Type	application/x-www-form-urlencoded

请求参数

参数	类型	必填	说明
member_id	string	是	玩家唯一标识（代理侧 ID）。仅允许字母、数字。自动转为小写
currency	string	否	货币代码（如 MYR、USD）。如提供，将自动创建 balance=0 的钱包。自动转为大写
nickname	string	否	玩家昵称
language	string	否	语言代码，如 zh-CN、en-US，默认 en-US

请求示例

curl -X POST https://api.example.com/papi/v1/player/register \
  -H "Authorization: Bearer {agent_token}" \
  -d "member_id=player001&currency=MYR&nickname=Player%20One&language=en-US"

响应字段

字段	类型	说明
player_id	string	玩家唯一 ID（平台 GUID）
member_id	string	原始 member_id（小写）
status	string	账号状态：active
currency	string	货币代码（仅在传入 currency 时返回）
balance	decimal	初始余额：0（仅在传入 currency 时返回）

响应示例

不带 currency

{
  "status": true,
  "code": 0,
  "data": {
    "player_id": "45eee69c-5f81-4ed6-9da3-435eaa51f1a1",
    "member_id": "player001",
    "status": "active"
  },
  "msg": "success"
}

带 currency

{
  "status": true,
  "code": 0,
  "data": {
    "player_id": "45eee69c-5f81-4ed6-9da3-435eaa51f1a1",
    "member_id": "player001",
    "status": "active",
    "currency": "MYR",
    "balance": 0
  },
  "msg": "success"
}

错误码

错误码	Message	说明
1001	err.param.invalid	member_id 缺失
1002	err.signature.invalid	Agent Token 验证失败
2002	err.player.duplicate	玩家已存在（同一代理下 member_id 重复）
2005	err.player.register_failed	注册过程错误
2006	err.player.member_id_invalid	member_id 格式错误（含非法字符）