Create Player
Create a new game player account.
API Information
- URL：
POST /v2/members - Authentication：Bearer Token
- Encryption：Requests are encrypted using AES-256-GCM; responses are returned as plaintext JSON
request
Request Headers
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
Request Parameters
Request parameters need to be encrypted and placed in the cipherText field.
Parameters Before Encryption
{
"username": "player001",
"siteId": "site01"
}
Encrypted Request
{
"cipherText": "G0ZMDELeJwx+7JcIfIFOLJjkSzANPu6krGM2uw==bDUB6MvLbggJM4Df28x/41LlgIPDqPBBAylkqTdB0I78haWOdi6jV8JXAi0iL8JHq/cCPlj39Apt..."
}
| Field | Type | Required | Description |
|---|---|---|---|
username | string | Yes | Player Account, a unique identifier. See Important Notes for the creation rules |
siteId | string | No | Site ID, used for managing multiple sites |
Response
Success Response
{
"code": 0,
"message": "No error.",
"logUUID": "24cdc3b9-9fe8-44de-8391-a96863e46954"
}
Error Response
When the request fails, the corresponding error code will be returned.
Error Codes
| Code | Description | Handling Suggestion |
|---|---|---|
| 6 | The username already exist | This Player Account is already in use. Please use a different Player Account |
| 11 | Parameters error | Please ensure the request parameters are complete and correctly formatted (username must be 1-25 letters or digits) |
Error Response Example
{
"code": 6,
"message": "The username already exist.",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
{
"code": 11,
"message": "Parameters error",
"logUUID": "6589bf8d-fe74-48bd-841a-71bf8f848f86"
}
Important Notes
- Player Account uniqueness: The Player Account must be unique under each agentId
- Player Account format restriction: Maximum 25 characters, letters and digits only, case-sensitive
- Site ID format restriction: Maximum 20 characters, letters and digits only, case-sensitive
- Site ID cannot be changed: Once created, it is difficult to change. Please name and confirm it carefully