# 项目管理 API

本页介绍了如何通过 API 获取项目列表。

## 获取项目列表

### URI

GET /projects

::: tip
该方法 60 分钟内只能请求 60 次。
:::

### 请求消息

无

### 响应消息

- **200:**

| 名称           | 类型   | 描述                                                  |
| -------------- | ------ | ------------------------------------------------------------ |
| projectID      | String | 项目的唯一标识符。'default' 表示默认项目。 |
| projectName    | String | 项目名称。                                         |
| description    | String | 项目描述。                                  |

- **401:** API Key 认证失败。
- **403:** API Key 没有权限访问。

### 请求示例

```bash
curl -u key:secret -X GET {api}/projects
```

### 响应示例

```json
[
    {
        "projectID": "p1234567",
        "projectName": "我的项目",
        "description": "用于 IoT 设备的项目"
    },
    {
        "projectID": "default",
        "projectName": "默认项目",
        "description": "所有部署的默认项目"
    }
]
```