사용자 정보 조회

사용자 상세 정보 조회

get

사용자명으로 특정 사용자의 상세 정보를 조회합니다.

---

주요 기능:

• 사용자의 기본 정보 (ID, 사용자명, 잔액 등)

• 게임 플레이 상태 확인

• 마지막 접속 정보

• 계정 상태 (킥 여부 등)

권한 요구사항:

• API Key 헤더 필수

• Agent ID 헤더 필수

• 해당 에이전트 소속 사용자만 조회 가능

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

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

Path parameters

usernamestring · min: 3 · max: 30Required

조회할 사용자명 (영문, 숫자, 언더스코어 허용)

Example: john_doePattern: /^[a-zA-Z0-9_가-힣]+$/

Responses

200

사용자 정보 조회 성공

application/json

400

잘못된 요청 파라미터

application/json

401

인증 실패 (API Key 또는 Agent ID 누락/잘못됨)

application/json

404

사용자를 찾을 수 없음

application/json

500

서버 내부 오류

application/json

get

/api/users/{username}

HTTPcURLJavaScriptPython

GET /api/users/{username} HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Accept: */*

{
  "id": 12345,
  "username": "john_doe",
  "provider_user_id": "PU_1234567890123456",
  "balance": 150000.75,
  "agent_id": 1,
  "idcode": "AGENT001",
  "is_kicked": false,
  "created_at": "2025-01-15T09:30:00.000Z",
  "updated_at": "2025-01-20T14:25:30.000Z"
}