跳至主要内容

創建會員

創建新的遊戲會員帳戶。

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​