# 调用 Product API

完成本页操作后，你将使用个人访问令牌列出当前账号可见的工作区，并保存一个工作区 ID 供后续请求使用。

## 1. 准备接入信息

从当前环境的开发者接入信息取得完整 Product API Base URL，并准备 UC 个人访问令牌：

```bash
export PRODUCT_API_BASE_URL='<Product API Base URL ending in /newmoi>'
export PRODUCT_API_KEY='<your-personal-access-token>'
```

Product API Base URL 必须包含 `/newmoi`。Product API 使用 `X-API-Key`，不要改用 Genesis Base URL 或 `Authorization: Bearer`。

## 2. 列出工作区

```bash
curl "$PRODUCT_API_BASE_URL/workspaces" \
  -H "X-API-Key: $PRODUCT_API_KEY" \
  -H "Accept: application/json"
```

工作区发现请求不发送 `X-Workspace-ID`。成功响应的 `data.workspaces` 是当前身份可见的工作区列表。

## 3. 保存工作区 ID

从 `data.workspaces[].id` 中选择目标工作区：

```bash
export WORKSPACE_ID='<workspace-id-from-response>'
```

后续工作区资源请求应同时发送：

```text
X-API-Key: <PERSONAL_ACCESS_TOKEN>
X-Workspace-ID: <WORKSPACE_ID>
```

如果列表为空，先确认当前账号已创建、加入或接受目标工作区邀请，不要根据工作区名称自行构造 ID。

## 下一步

- [查看 Product API 完整开始指南](../api/product-api/getting-started.md)
- [检查工作区成员和当前身份](../api/product-api/workspaces-members.md)
- [运行、查询和取消工作流](../api/product-api/workflows-workitems-lineage/run-query-cancel.md)