下载已购买的文件

目前不提供在线购买。请使用 catabricks catalog list 查看公开商品，或咨询数据使用。遇到 SALES_DISABLED 或 PAYMENT_NOT_CONFIGURED 时，请停止重试购买。提交咨询不会授予文件访问权限；已有订单的下载仍遵循其权限和期限。

请先安装 CLI。以下示例基于 CLI 0.2.5。

1. 登录

复制catabricks login

在浏览器中使用 Google 登录，核对终端显示的设备代码后批准请求。

2. 查找订单 ID

复制catabricks orders list

找到想下载的已购文件，复制其 data.items[].id。这就是下一条命令中的 ORDER_ID。

以下 JSON 仅展示部分字段，用于说明。ID 和商品名不是真实订单，请使用自己的命令输出。默认输出为缩进 JSON，添加 --json 可改为单行输出。

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

3. 下载

将 ORDER_ID 替换为复制的订单 ID。--output 指定文件保存路径。

复制catabricks download ORDER_ID --output ./dataset.zip

下载后，CLI 会验证文件大小和 SHA-256。显示 "ok": true 和保存路径即表示完成。只有支付完成且文件已准备好交付的订单才能下载。

下载中断时，使用相同订单和路径并添加 --resume 继续下载。请同时保留 .part 和 .part.json 文件。

复制catabricks download ORDER_ID --output ./dataset.zip --resume

如需稍后再次验证，请运行 catabricks verify ./dataset.zip --order ORDER_ID。下载期限内可重复下载。

购买新数据

如果还没有已购订单，请先查看公开商品目录。浏览商品无需登录。

复制catabricks catalog list

以下同样是仅展示部分字段的说明用示例。Product.id 用于查看商品，offerId 用于购买，两者是不同的 ID。

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

将商品的 id 填入 PRODUCT_ID，确认内容、格式、许可协议、整套价格 priceKrw 和下载期限 downloadHours。购买时，将该商品的 offerId 填入 OFFER_ID。

复制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 按照上方步骤下载。组织购买请参阅命令参考。

结束会话

完成后运行 catabricks logout 结束当前 CLI 会话。如需结束所有 CLI 会话，请改用 catabricks logout --all。已下载的文件会保留。