파트너 정보 조회

에이전트 정보 및 하위 통계 조회

get

현재 인증된 에이전트의 기본 정보와 하위 조직 통계를 종합 조회합니다.

조회되는 에이전트 정보:

• 기본 정보: ID, 사용자명, 닉네임, 상태

• 계층 정보: 부모 에이전트, 깊이, ID코드

• 자산 정보: 현재 Pots, 환전 수수료율

• 설정 정보: 지갑 타입, API 키, 콜백 URL

• 메타 정보: 생성/수정 일시, 메모

하위 조직 통계:

• 하위 파트너: 본인 하위의 모든 에이전트 수 및 총 Pots

• 직속 사용자: 본인에게 직접 연결된 사용자 수 및 총 Balance

계층 구조 설명:

• idcode를 기준으로 하위 조직 식별 (예: "1/2/3")

• 하위 파트너: idcode가 "본인idcode/"로 시작하는 모든 에이전트

• 직속 사용자: agent_id가 본인 ID인 사용자들만

권한 및 보안:

• API Key + Agent ID 헤더 인증 필수

• 본인의 정보와 통계만 조회 가능

• 민감한 정보 (비밀번호 등)는 제외하고 반환

활용 시나리오:

• 에이전트 대시보드 메인 화면

• 조직 현황 파악 및 관리

• 자산 및 사용자 현황 모니터링

• 상위 에이전트와의 관계 확인

Authorizations

ApiKeyAuthAgentIdAuth

api-keystringRequired

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

Responses

200

에이전트 정보와 하위 조직 통계 조회 성공

application/json

400

잘못된 요청 - 필수 헤더 누락

application/json

401

인증 실패 - 유효하지 않은 API 키 또는 에이전트 ID

application/json

500

내부 서버 오류

application/json

get

/api/agents/my-info

HTTPcURLJavaScriptPython

GET /api/agents/my-info HTTP/1.1
Host: {HIGHEND-API-SERVER}
api-key: YOUR_API_KEY
Accept: */*

{
  "agent": {
    "id": 123,
    "username": "agent001",
    "nickname": "에이전트01",
    "status": "ACTIVE",
    "currency": "KRW",
    "idcode": "1/2/3",
    "parent_id": 2,
    "depth": 2,
    "pots": "12345.67",
    "pots_exchange_rate_percent": 10,
    "memo_from_parent": "우수 에이전트",
    "created_at": "2024-01-01T00:00:00.000Z",
    "updated_at": "2024-01-15T10:30:00.000Z",
    "wallet_type": "SEAMLESS",
    "api_key": "67eb8985-5b42-4c13-a71a-ac57e94579f8",
    "callback_url": "https://partner.example.com/api/callback",
    "parent": {
      "id": 2,
      "username": "parent_agent",
      "nickname": "상위 에이전트",
      "status": "ACTIVE"
    }
  },
  "totalCountOfUnderAgent": 5,
  "totalPotsOfUnderAgent": "9999.99",
  "totalCountOfUnderUser": 150,
  "totalBalanceOfUnderUser": "123456.78"
}