# 创建项目 (/zh-CN/api-reference/api-ref/console/create-project)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

创建一个新的声网项目。

- OpenAPI: /openapi/console/rest-api.zh-CN.yaml
- Operation ID: post-dev-v1-project
- Method: POST
- Path: /dev/v1/project
- Endpoint: https://api.sd-rtn.com/dev/v1/project

## Servers

- https://api.sd-rtn.com

:::warning[注意]
- 一个账户最多可创建 20 个项目，包括已删除的项目。如果需要创建更多项目，请通过[工单系统](https://ticket.shengwang.cn)申请。
- 在 2021 年 10 月 1 日前注册的账户最多可创建 10 个项目，包括已删除的项目。如果需要创建更多项目，请通过[工单系统](https://ticket.shengwang.cn)申请。
:::

## Authorization

This endpoint requires authentication.

- `Authorization`

## Parameters

No parameters.

## Request body

- `name` (string, required) - 项目名称，长度为 1 ~ 255 个字符。
- `enable_sign_key` (boolean, required) - 是否启用主要 App 证书：
- `true`：启用
- `false`：（默认）不启用

创建项目后，你可以调用[启用或禁用主要 App 证书](/zh-CN/api-reference/api-ref/console/update-primary-app-certificate)，或调用[重置主要 App 证书](/zh-CN/api-reference/api-ref/console/reset-primary-app-certificate)。

### Request body example

```json
{
  "name": "project1",
  "enable_sign_key": true
}
```

## Responses

### 201

如果状态码为 201，则请求成功。

- `project` (array)
  - `project.items` (object)
    - `project.items.id` (string) - 项目 ID。
    - `project.items.name` (string) - 项目名称。
    - `project.items.vendor_key` (string) - 项目的 App ID。
    - `project.items.status` (number) - 项目状态。
- `1`：启用
- `0`：禁用
    - `project.items.created` (number) - 项目的创建时间，Unix 时间戳，单位为秒。
### 非 201

如果状态码不为 201，请求失败。请根据[响应状态码](response-codes)和 `message` 字段进行排查。

- `status` (string) - 本次请求的状态：
- `success`：请求成功。
- `error`：请求失败。

- `message` (string) - 描述请求失败的原因。

## Response examples

### 201

```json
{
  "project": [
    {
      "id": "xxxx",
      "name": "project1",
      "vendor_key": "4855xxxxxxxxxxxxxxxxxxxxxxxxeae2",
      "status": 1,
      "created": 1464165672
    }
  ]
}
```
### 非 201

```json
{
  "status": "error",
  "message": "string"
}
```