# 구매한 파일 다운로드

현재 온라인 구매는 제공하지 않습니다. `catabricks catalog list`로 공개 상품을 조회하거나 [데이터 이용 문의](/contact)를 이용하세요. `SALES_DISABLED` 또는 `PAYMENT_NOT_CONFIGURED`이면 구매 재시도를 중단하세요. 문의 접수만으로 파일 권한이 생기지는 않으며, 기존 주문의 다운로드는 해당 주문 권한과 기한을 따릅니다.

먼저 [CLI 설치](/docs/cli)를 완료하세요. 아래 예시는 CLI 0.2.5 기준입니다.

## 1. 로그인

```sh
catabricks login
```

브라우저에서 Google 계정으로 로그인하고 터미널에 표시된 기기 코드를 확인해 승인하세요.

## 2. 주문 ID 확인

```sh
catabricks orders list
```

구매한 주문 중 원하는 파일의 `data.items[].id`를 복사하세요. 이것이 다음 명령의 `ORDER_ID`입니다.

아래는 필드를 일부만 표시한 설명용 JSON 예시입니다. ID와 상품명은 실제 주문이 아니므로 본인의 실행 결과를 사용하세요. 기본 출력은 들여쓰기된 JSON이며, `--json`을 붙이면 한 줄로 출력합니다.

```json
{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "93db21a6-0f62-40d9-a4e8-56d7a954c4b2",
        "productTitle": "Example dataset"
      }
    ]
  }
}
```

## 3. 다운로드

`ORDER_ID`를 복사한 주문 ID로 바꾸세요. `--output`은 저장할 파일 경로입니다.

```sh
catabricks download ORDER_ID --output ./dataset.zip
```

다운로드가 끝나면 CLI가 파일 크기와 SHA-256을 검증합니다. `"ok": true`와 저장 경로가 출력되면 완료입니다. 결제가 완료되고 파일 전달이 준비된 주문만 받을 수 있습니다.

중단된 다운로드는 같은 주문과 경로에 `--resume`을 붙여 이어받습니다. `.part`와 `.part.json` 파일을 함께 보존하세요.

```sh
catabricks download ORDER_ID --output ./dataset.zip --resume
```

나중에 파일을 다시 검증하려면 `catabricks verify ./dataset.zip --order ORDER_ID`를 실행하세요. 다운로드 가능 기간 안에는 반복해서 받을 수 있습니다.

## 새로 구매하려면

아직 구매한 주문이 없다면 공개 상품부터 확인하세요. 상품 조회에는 로그인이 필요하지 않습니다.

```sh
catabricks catalog list
```

아래 역시 설명용 일부 필드입니다. `Product.id`는 상품 조회용, `offerId`는 구매용입니다. 서로 바꾸어 사용하지 마세요.

```json
{
  "ok": true,
  "data": {
    "items": [
      {
        "id": "78c3be2a-3f14-4bf2-a219-e985443d3c79",
        "title": "Example dataset",
        "offerId": "d6a92d43-f931-44af-b3b2-8c26f2aa24b8"
      }
    ]
  }
}
```

`PRODUCT_ID`에는 상품의 `id`를 넣어 구성·포맷·라이선스·전체 가격 `priceKrw`·다운로드 기간 `downloadHours`를 확인하세요. 구매할 때는 해당 상품의 `offerId`를 `OFFER_ID`에 넣습니다.

```sh
catabricks catalog show PRODUCT_ID
catabricks buy OFFER_ID --buyer personal
```

`buy`는 주문을 준비하고 결제 페이지를 엽니다. 같은 Google 계정으로 금액·조건·구매 주체를 확인한 뒤 브라우저에서 직접 결제하세요. CLI에 카드 정보를 입력하지 않습니다. 실제 상품과 가격은 현재 조회 결과를 따릅니다.

`buy` 결과의 `data.orderId`가 새 주문의 `Order.id`입니다. `orders list`에서는 같은 값이 `data.items[].id`로 나옵니다. 결제 후 이 ID로 위 다운로드 단계를 진행하세요. 조직 구매는 [명령 참조](/docs/cli/reference)를 확인하세요.

## 세션 종료

작업을 마치면 `catabricks logout`으로 현재 CLI 세션을 종료합니다. 모든 CLI 세션을 종료하려면 대신 `catabricks logout --all`을 사용하세요. 다운로드한 파일은 유지됩니다.