문서 본문으로 이동
문서API 참조서버 목록 조회
GETBearer 토큰

서버 목록 조회

/api/v1/servers

조직 서버의 리전, 요금제, 상태, 자동 갱신 설정과 만료일을 조회합니다. 로그인 인증 정보는 포함되지 않습니다.

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

요청 예시

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

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

응답 예시
JSON
{
  "servers": [],
  "dashboard": "https://tovahub.com/dashboard/servers"
}

매개변수

매개변수가 없습니다.

응답

HTTP 상태 200

로그인 인증 정보 없이 조직의 현재 삭제되지 않은 서버를 나열합니다.

serversarray

현재 서버 요약입니다.

servers[].idstring (ObjectId)

플랫폼 서버 식별자입니다.

servers[].hostnamestring | null

저장된 호스트 이름입니다.

servers[].planstring

요금제 식별자입니다. 이 응답은 planId가 아닌 plan을 사용합니다.

servers[].regionstring

지역 코드입니다.

servers[].statusstring

정규화된 저장 서버 상태입니다.

servers[].autoRenewboolean

저장된 사이트 자동 갱신 설정입니다.

servers[].expiresAtstring (ISO 8601) | null

저장된 결제한 이용 기간의 종료일입니다.

servers[].testOnlyboolean

격리된 테스트 리소스인지 나타냅니다.

servers[].testUntilstring (ISO 8601) | null

테스트 만료 시각이며, 있는 경우에만 제공됩니다.

servers[].updatedAtstring (ISO 8601)

서버 기록의 최종 업데이트 시각입니다.

servers[].statusCheckedAtstring (ISO 8601) | null

마지막 상태 관측 타임스탬프입니다.

dashboardstring (URL)

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