跳到主要内容

創建会员

創建新的游戏会员账户。

API 信息​

  • 端点：POST /v2/members
  • 认证：Bearer Token
  • 加密：请求使用 AES-256-GCM 加密，响应为明文 JSON

请求​

请求标头​

POST /v2/members HTTP/1.1
Host: api.example.com
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...
x-agentid: integratorNBTest04
x-timestamp: 1769746894501
x-nonce: 56ffd5ecd8a3a4457863a0bd7c298fb2
x-signature: 904e97bee2589b93e9747eed0346c68b23d8ff8b568dabaf4b94a5e89093df67

请求参数​

请求参数需要加密后放入 cipherText 欄位。

加密前的参数​

{
  "username": "player001",
  "siteId": "site01"
}

加密后的请求​

{
  "cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==bDUB6MvLbggJM4Df28x/41LlgIPDqPBBAylkqTdB0I78haWOdi6jV8JXAi0iL8JHq/cCPlj39Apt..."
}
欄位类型必填说明
usernamestring是会员账号，唯一标識符，創建规则参考注意事项
siteIdstring否站点 ID，用于多站点管理

响应​

成功响应​

{
  "code": 0,
  "message": "No error.",
  "logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}

错误响应​

当请求失敗时，会返回对应的错误代码。

错误代码​

状态码说明处理建议
6The username already exist用户名已被使用，请使用其他用户名
11Parameters error请确认请求参数完整且格式正确（username 需为 1-25 个字母或数字）

错误响应范例​

{
  "code": 6,
  "message": "The username already exist.",
  "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
{
  "code": 11,
  "message": "Parameters error",
  "logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}

注意事项​

  1. 用户名唯一性：每个 agentId 下的用户名必须唯一
  2. 名稱限制：最長 25 个字符，僅为英数字混合，允许大小写
  3. 站点ID限制：最長 20 个字符，一但建立则不易更动，请妥善命名与确认

相关 API​