# curl {/* #curl */}

首先阅读 [REST 指南](/docs/zh/api/rest)，创建平台 API 令牌。

列出前十个目录：

```bash
curl -fsS "https://reconstruct.dev/api/v1/platform/catalogs?pageSize=10" \
  -H "Authorization: Bearer ${CR_RECONSTRUCT_API_TOKEN}"
```

要读取某个目录，从列表响应中复制其 `catalogId`，并在路径中进行 URL 编码：

```bash
curl -fsS "https://reconstruct.dev/api/v1/platform/catalogs/CATALOG_ID" \
  -H "Authorization: Bearer ${CR_RECONSTRUCT_API_TOKEN}"
```

如果列表响应包含 `nextPageToken`，将其作为 URL 编码的 `pageToken` 查询参数传入，以获取下一页。