저장 객체 트리

GET

/api/v1/stations/{station_id}/objects/tree

const url = 'https://dev.api.endueos.com/api/v1/stations/stn_01J9ZK3Q8M4XW7D2N5R6T0V1BC/objects/tree';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://dev.api.endueos.com/api/v1/stations/stn_01J9ZK3Q8M4XW7D2N5R6T0V1BC/objects/tree \
  --header 'Authorization: Bearer <token>'

객체 이름의 / 를 폴더로 보아 한 층을 돌려준다 (D-55) — 그 층의 폴더(개수·크기)와 객체. 폴더 표는 없다 — 이름 규칙만으로 만든다. 기기 안의 파일은 명령(list_dir 등)으로 본다.

인증

파라미터

경로 파라미터

station_id

필수

string

/^stn_[0-9A-HJKMNP-TV-Z]{26}$/

예시

stn_01J9ZK3Q8M4XW7D2N5R6T0V1BC

쿼리 파라미터

prefix

string

''(맨 위, 기본) 또는 / 로 끝나는 값 (예: screens/2026/). 아니면 400 VALIDATION_ERROR.

응답

200

성공.

application/json

object

data

필수

저장 객체를 이름의 / 로 나눈 트리의 한 층.

object

station_id

필수

string

/^stn_[0-9A-HJKMNP-TV-Z]{26}$/

prefix

필수

이 층의 접두사 — ''(맨 위) 또는 / 로 끝나는 값.

string

folders

필수

이 층 바로 아래의 폴더. 이름순.

Array<object>

객체 트리의 폴더 하나. 폴더 표는 없다 — 객체 이름의 / 앞부분이 곧 폴더다 (D-55).

object

prefix

필수

이 폴더의 전체 접두사. / 로 끝난다 (예: screens/2026/). 다음 층을 볼 때 prefix 로 넘긴다.

string

name

필수

폴더 이름 — prefix 의 마지막 칸 (/ 없이).

string

object_count

필수

이 폴더 아래(하위 폴더 포함)의 객체 수.

integer format: int32

size_bytes

필수

이 폴더 아래(하위 폴더 포함)의 객체 크기 합계.

integer format: int64

objects

필수

이 층에 바로 있는 객체 (name 은 접두사를 포함한 전체 이름). 이름순, 최대 1000.

Array<object>

object

storage_object_id

필수

string

/^sobj_[0-9A-HJKMNP-TV-Z]{26}$/

station_id

필수

string

/^stn_[0-9A-HJKMNP-TV-Z]{26}$/

name

필수

string

content_type

필수

string

size_bytes

필수

integer format: int64

sha256

필수

본문의 SHA-256 (hex).

string

source

필수

string

허용 값: upload command

source_resource_id

필수

Any of:

string
null

string

/^res_[0-9A-HJKMNP-TV-Z]{26}$/

source_command_id

필수

Any of:

string
null

string

/^cmd_[0-9A-HJKMNP-TV-Z]{26}$/

created_at

필수

string format: date-time

truncated

필수

objects 가 한도에서 잘렸다.

boolean

meta

필수

object

request_id

필수

string

timestamp

필수

string format: date-time

duration

서버 처리 시간(ms).

integer format: int32

예시

{
  "data": {
    "station_id": "stn_01J9ZK3Q8M4XW7D2N5R6T0V1BC",
    "objects": [
      {
        "storage_object_id": "sobj_01J9ZK3Q8M4XW7D2N5R6T0V1BC",
        "station_id": "stn_01J9ZK3Q8M4XW7D2N5R6T0V1BC",
        "source": "upload",
        "source_resource_id": "res_01J9ZK3Q8M4XW7D2N5R6T0V1BC",
        "source_command_id": "cmd_01J9ZK3Q8M4XW7D2N5R6T0V1BC"
      }
    ]
  }
}

400

요청 형식이 틀렸다 — VALIDATION_ERROR(details.errors[]) 또는 BAD_REQUEST. 본문은 오류 봉투.

401

인증이 없거나 무효다 — UNAUTHORIZED. 본문은 오류 봉투.

404

없거나 내 것이 아니다 — *_NOT_FOUND. 본문은 오류 봉투.

429

한도를 넘었다 — Retry-After 초 뒤에 다시. 본문은 오류 봉투.

500

서버 오류 — INTERNAL_ERROR. 본문은 오류 봉투.

503

의존 서비스에 닿지 못했다 — 잠시 뒤 다시. 본문은 오류 봉투.