사용자 생성

새 사용자 생성

post

새로운 사용자를 생성합니다.

동일 에이전트 내에서 사용자명은 반드시 고유해야 합니다. 이미 동일한 username이 존재하는 경우, 에러가 반환됩니다.

api/games/get-game-url API를 사용하면 사용자를 생성함과 동시에 일회성 게임 URL을 발급할 수 있습니다. API 파라미터에 displayName을 지정하지 않으면, username이 회원의 게임 화면 닉네임으로 표시됩니다.

---

주요 기능:

• 고유한 사용자명으로 사용자 생성

• 자동으로 Provider User ID 생성

• 에이전트 정보 연결

• 기본 잔액 0으로 설정

사용자명 규칙:

• 3-30자 길이

• 영문, 숫자만 허용

• 동일 에이전트 내에서 고유해야 함

자동 생성 필드:

• provider_user_id: 20자리 고유 ID

• balance: 0으로 초기화

• idcode: 에이전트의 idcode 상속

권한 요구사항:

• API Key 헤더 필수

• Agent ID 헤더 필수

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

에이전트별 발급된 API 키를 입력하세요

Body

application/json

usernamestring · min: 3 · max: 30Required

새로 생성할 사용자의 이름

Example: 홍길동_2024Pattern: ^[a-zA-Z0-9_가-힣]+$

Responses

201

사용자 생성 성공

application/json

400

유효성 검사 실패

application/json

401

인증 실패

application/json

409

사용자명이 이미 존재함

application/json

500

서버 내부 오류

application/json

post

/api/users/create

HTTPcURLJavaScriptPython

POST /api/users/create HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 26

{
  "username": "new_user123"
}

표준 사용자 생성한글 포함 사용자명언더스코어 사용

{
  "id": 12346,
  "username": "new_user123",
  "provider_user_id": "PU_9876543210987654",
  "balance": 0,
  "agent_id": 1,
  "idcode": "AGENT001",
  "is_kicked": false,
  "created_at": "2025-01-21T10:15:00.000Z",
  "updated_at": "2025-01-21T10:15:00.000Z"
}