v5.101.0：REST API 开放日志资源

更新内容

1. 开放登录日志和审计日志资源
2. 产品、项目、测试库和知识库成员支持团队
3. 在 Scrum 类型的项目中允许任务不挂在用户故事上
4. 允许管理产品中的需求模块
5. 新增删除一个发布

开放登录日志和审计日志资源

支持获取登录日志列表。可以通过 logged_between 参数限定登录时间范围；通过 user_ids 参数限定登录人的 ids。

GET /v1/security/login_logs?logged_between=&user_ids=
{
	……
    "values": [
        {
            "id": "5fca7b74efab845a2fa53181",
            "url": "https://rest_api_root/v1/security/login_logs/5fca7b74efab845a2fa53181",
            "user": {
                "id": "a0417f68e846aae315c85d24643678a9",
                "url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
                "name": "john",
                "display_name": "John",
                "avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
            },
            "login_method": "账号密码",
            "region": "北京海淀区",
            "ip": "45.251.20.42",
            "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36",
            "created_at": 1676454024
        }
    ]
}

支持获取审计日志列表。可以通过 operated_between 参数限定操作时间范围；通过 operated_bys 参数限定操作人的 ids。

GET /v1/security/audit_logs
{
	……
    "values": [
        {
            "id": "5fca7b74efab845a2fa53181",
            "url": "https://rest_api_root/v1/security/audit_logs/5fca7b74efab845a2fa53181",
            "operated_by": {
                "id": "a0417f68e846aae315c85d24643678a9",
                "url": "https://rest_api_root/v1/directory/users/a0417f68e846aae315c85d24643678a9",
                "name": "john",
                "display_name": "John",
                "avatar": "https://s3.amazonaws.com/bucket/b46ef40c-e22e-4ecf-a599-cace9fba839a_160x160.png"
            },
            "operated_at": 1676454024,
            "operate_object": "规则",
            "application": "自动化",
            "ip": "45.251.20.42",
            "summary": "修改规则",
            "detail": "规则：规则1\n类型：自动化规则\n描述：-"
        }
    ]
}

产品、项目、测试库和知识库成员支持团队

例如在创建项目/复制项目时，可通过 members: [{ id: "团队id", type: "user_group" }] 参数指定团队；在向项目中添加一个成员时，可通过 member: { id: "团队id", type: "user_group" } 参数指定团队。

// 创建项目
POST /v1/project/projects
{
  	……
    "members": [
        {
            "id": "64ca0f67cb78a0a80e1a9999",
            "type": "user_group"
        }
    ]
}
// 向项目中添加一个成员
POST /v1/project/projects/{project_id}/members
{
  	……
    "member": {
        "id": "64ca0f67cb78a0a80e1a9999",
        "type": "user_group"
    }
}

在 Scrum 类型的项目中允许任务不挂在用户故事上

在 Scrum 类型的项目中允许任务独立存在，可以不挂在用户故事上，可以直接放入迭代和发布中。

允许管理产品中的需求模块

允许在产品中添加和移除需求模块：

// 向产品中添加一个需求模块
POST /v1/ship/products/{product_id}/suites
// 获取产品中的需求模块列表
GET /v1/ship/products/{product_id}/suites
// 在产品中移除一个需求模块
DELETE /v1/ship/products/{product_id}/suites/{suite_id}

新增删除一个发布

新增删除一个发布：

DELETE /v1/project/projects/{project_id}/versions/{version_id}

其他

• 修复一些已知缺陷

更多功能，详见 REST API 官方文档