문서 본문으로 이동
문서API 참조서버 요약 조회
GETBearer 토큰

서버 요약 조회

/api/v1/servers/summary

완료된 구매 수와 현재 서버의 상태별, 리전별, 자동 갱신 설정별 요약을 조회합니다.

API 필드명, 자료형, 코드는 모든 언어에서 그대로 유지됩니다.

요청 예시

cURL
curl "https://tovahub.com/api/v1/servers/summary" \
  -H "Authorization: Bearer $TOVAHUB_TOKEN"

예시만 표시합니다. 이 페이지는 API 요청을 보내지 않습니다.

응답 예시
JSON
{
  "completedPurchases": 0,
  "purchasesByRegion": [],
  "currentServers": 0,
  "serversByStatus": [],
  "serversByRegion": [],
  "autoRenewEnabled": 0,
  "autoRenewDisabled": 0,
  "management": "Manage servers, renewals, and account settings in the TovaHub Dashboard.",
  "dashboard": "https://tovahub.com/dashboard/servers"
}

매개변수

매개변수가 없습니다.

응답

HTTP 상태 200

완료된 구매와 현재 조직의 삭제되지 않은 서버 기록을 요약합니다.

completedPurchasesnumber

완료된 구매 수입니다.

purchasesByRegionarray

지역별로 집계한 완료 구매 수입니다.

purchasesByRegion[].regionstring

지역 코드입니다.

purchasesByRegion[].countnumber

구매 수입니다.

currentServersnumber

현재 삭제되지 않은 서버 수입니다.

serversByStatusarray

정규화된 상태별로 집계한 현재 서버 수입니다.

serversByStatus[].statusstring

정규화된 상태입니다.

serversByStatus[].countnumber

서버 수입니다.

serversByRegionarray

지역별로 집계한 현재 서버 수입니다.

serversByRegion[].regionstring

지역 코드입니다.

serversByRegion[].countnumber

서버 수입니다.

autoRenewEnablednumber

자동 갱신 설정이 활성화된 서버 수입니다.

autoRenewDisablednumber

자동 갱신 설정이 비활성화된 서버 수입니다.

managementstring

대시보드 관리 안내입니다.

dashboardstring (URL)

대시보드 서버 목록 URL입니다.