[POST] 유저 생성

META에 유저를 에이전트 소속으로 생성합니다.

이미 동일한 username를 가진 유저가 있으면, 에러를 반환합니다.

[Game] 일회성 게임 URL 생성으로 유저 생성과 동시에 url을 생성할 수 있습니다.

---

Create a new user

POST /api/users/create

Body

Name	Type	Description
username*	String	에이전트 시스템에서 유저를 유일하게 식별하기 위한 값입니다.

username는 다음 규칙을 따라주세요.

- 길이는 1~36자 사이에서 가능합니다.

- 한글, 알파벳 소문자, 숫자만을 허용합니다.

위 규칙을 지키지 않은 유저에 대해서 META는 정상동작을 보장할 수 없습니다.

[Game] 일회성 게임 URL 생성 API 호출 시, API 파라미터로 displayName을 사용하지 않으면

username이 회원의 게임창에 닉네임으로 표시됩니다.

Example

example body 1

{
    "username": "mario0070"
}

example body 2

example body 3

Response

201 Create success

//User object
{
  "id": 1,
  "provider_user_id": "12345678901234567890",
  "username": "mario0070",
  "balance": "0",
  "game_url_token": null,
  "last_accessed_game_id": null,
  "last_accessed_at": null,
  "isPlaying": false,
  "kick_until": null,
  "updated_at": "2025-06-18T09:10:00.000Z",
  "created_at": "2025-06-10T12:00:00.000Z",
  "agent_id": 1,
  "idcode": "1/1"
}

409 Conflict error