Skip to content

设计稿 designs

设计稿(原型)是版本化管理的原型单元,归属于某个组织。

GET /api/orgs/:id/designs

列出组织下所有设计稿。

鉴权:需 Authorization: Bearer <JWT>,调用者须为该组织成员。

响应 200

json
{ "designs": [{ "id": "...", "name": "...", "orgId": "..." }] }

POST /api/orgs/:id/designs

在组织下创建新设计稿。

鉴权:需 Authorization: Bearer <JWT>,调用者须为该组织成员。

请求体(JSON)

字段类型必填说明
namestring设计稿名称
descriptionstring描述

响应 201

json
{ "design": { "id": "...", "name": "...", "orgId": "..." } }

GET /api/designs/:id

获取设计稿详情,含所有版本列表。

鉴权:需 Authorization: Bearer <JWT>,调用者须为该设计稿所属组织成员。

响应 200

json
{
  "design": { "id": "...", "name": "..." },
  "versions": [{ "id": "...", "number": 1, "createdAt": "..." }]
}

DELETE /api/designs/:id

删除设计稿。需 admin 及以上角色。

鉴权:需 Authorization: Bearer <JWT>(admin+)

响应 200

json
{ "ok": true }

上传版本见 上传版本 versions