# 查询空间列表

查询当前 App Key 可访问的空间列表，用于获取[空间账单](https://avavox.com/docs/developer/bill/space.html)、[机器人账单](https://avavox.com/docs/developer/bill/robot.html)、[任务账单](https://avavox.com/docs/developer/bill/task.html)接口中 `spaceIds` 参数所需的空间 ID。

<span style="display:inline-block;background:#e6f8ea;color:#22a366;border-radius:6px;padding:2px 8px;font-weight:bold;font-family:monospace;margin-right:8px;">GET</span>
`https://dashboard.avavox.com/open/api/v1/spaces`

::: warning 权限说明
授权范围为「全部空间」的 Key 返回企业下的全部空间；授权范围为「仅当前空间」的 Key 只返回其绑定的那一个空间。
:::

## 请求头

<span style="font-family:monospace; color:#3451b2; ">Authorization </span> <code style="background:#f0f0f0; ">string</code> <span style="background:#dc3545; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">必填</span>

- 填写格式：`Authorization: Bearer <App Key>`
- `<App Key>` 为控制台「App Key 管理」页面生成的 Key。
- 获取方式详见：[《App Key 创建与管理》](https://avavox.com/docs/developer/app-key.html)。

## 请求参数

<span style="font-family:monospace; color:#3451b2;">page</span> <code style="background:#f0f0f0;">int</code> <span style="background:#28a745; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">可选</span>

页码，从 1 开始，默认 `1`。

---

<span style="font-family:monospace; color:#3451b2;">pageSize</span> <code style="background:#f0f0f0;">int</code> <span style="background:#28a745; color:white; padding:2px 6px; border-radius:3px; font-size:12px;">可选</span>

每页条数，默认 `20`，最大 `100`。

## 响应数据

<span style="font-family:monospace; color:#3451b2;">code</span> <code style="background:#f0f0f0;">int</code>

状态码，200 为成功，其他状态均为失败。

---

<span style="font-family:monospace; color:#3451b2;">success</span> <code style="background:#f0f0f0;">boolean</code>

是否成功，`true` 表示成功，`false` 表示失败。

---

<span style="font-family:monospace; color:#3451b2;">message</span> <code style="background:#f0f0f0;">string</code>

描述信息。

---

<span style="font-family:monospace; color:#3451b2;">data</span> <code style="background:#f0f0f0;">object</code>

<details>
<summary>点击展开字段说明</summary>
<div style="margin: 16px 0; padding: 16px;  border-left: 1px solid #f0f0f0; border-radius: 6px;">

<span style="font-family:monospace; color:#3451b2;">total</span> <code style="background:#f0f0f0;">int</code>

可访问的空间总数。

---

<span style="font-family:monospace; color:#3451b2;">list</span> <code style="background:#f0f0f0;">array</code>

空间列表，元素结构：`spaceId`（空间 ID）、`spaceName`（空间名称）。

</div>
</details>

## 请求示例

```shell
curl -X GET --location 'https://dashboard.avavox.com/open/api/v1/spaces' \
--header 'Authorization: Bearer $Key'
```

## 响应示例

```json
{
  "code": 200,
  "message": "操作成功",
  "success": true,
  "data": {
    "total": 4,
    "list": [
      { "spaceId": "sp_default", "spaceName": "默认空间" },
      { "spaceId": "sp_001",     "spaceName": "花花" },
      { "spaceId": "sp_002",     "spaceName": "同道精英" },
      { "spaceId": "sp_003",     "spaceName": "保全" }
    ]
  }
}
```