主题
设计稿 designs
设计稿(原型)是版本化管理的原型单元,归属于某个组织。
GET /api/orgs/:id/designs
列出组织下所有设计稿。
鉴权:需 Authorization: Bearer <JWT>,调用者须为该组织成员。
响应 200
json
{ "designs": [{ "id": "...", "name": "...", "orgId": "..." }] }POST /api/orgs/:id/designs
在组织下创建新设计稿。
鉴权:需 Authorization: Bearer <JWT>,调用者须为该组织成员。
请求体(JSON)
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 是 | 设计稿名称 |
description | string | 否 | 描述 |
响应 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。