九游平台/ 代码托管 codearts repo/ api参考/ / / 获取检视意见设置
更新时间:2024-11-08 gmt 08:00

获取检视意见设置-九游平台

功能介绍

获取检视意见设置

调试

您可以在中调试该接口,支持自动认证鉴权。api explorer可以自动生成sdk代码示例,并提供sdk代码示例调试功能。

uri

get /v2/repositories/{repository_id}/review_setting

表1 路径参数

参数

是否必选

参数类型

描述

repository_id

integer

参数解释:

仓库id。

约束限制:

必传。

取值范围:

最小值:1

最大值:2147483647

请求参数

表2 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

string

参数解释:

用户token。通过调用iam服务获取用户token接口获取(响应消息头中x-subject-token的值)。

约束限制:

必传。

取值范围:

字符串长度不少于1,不超过10万。

默认取值:

不涉及。

响应参数

状态码: 200

表3 响应body参数

参数

参数类型

描述

error

error object

参数解释:

响应错误码

result

reviewsettingdto object

参数解释:

返回新建检视意见的相关信息。

取值范围:

无。

status

string

参数解释:

响应状态。

取值范围:

  • success,表示接口调用成功。
  • failed,表示接口调用失败。
表4 error

参数

参数类型

描述

code

string

参数解释:

调用此接口失败时返回的错误码。

取值范围:

  • ch.10000,系统繁忙,请稍后再试。

message

string

参数解释:

调用此接口失败时返回的提示信息。

取值范围:

  • “系统繁忙,请稍后再试”
表5 reviewsettingdto

参数

参数类型

描述

categories_and_modules_enabled

boolean

参数解释:

是否启用检视意见分类与模块。

取值范围:

  • true:启用检视意见分类与模块。
  • false:禁用检视意见分类与模块。

secondary_category_enabled

boolean

参数解释:

是否启用系统预置检视意见分类。

取值范围:

  • true:启用系统预置检视意见分类。
  • false:禁用系统预置检视意见分类,此时可勾选分类或添加自定义分类。

primary_categories

array of categorydto objects

参数解释:

已勾选的分类。

取值范围:

无。

review_default_categories

array of strings

参数解释:

已勾选的分类的key。

取值范围:

无。

review_customized_categories

array of strings

参数解释:

自定义分类。

取值范围:

数量限制:20条。

单条长度限制:200字符。

单条字符限制:unicode编码\u0000 - \uffff,不支持emoji表情、部分生僻字等特殊字符。

单条blank限制:不能为null或空字符串或全是空格。

review_modules

array of strings

参数解释:

检视意见模块。

取值范围:

数量限制:20条。

单条长度限制:200字符。

单条字符限制:unicode编码\u0000 - \uffff,不支持emoji表情、部分生僻字等特殊字符。

单条blank限制:不能为null或空字符串或全是空格。

source_id

integer

参数解释:

仓库id。

取值范围:

最小值:1

最大值:2147483647

source_type

string

参数解释:

项目类型,目前仅支持一种。

取值范围:

  • project

source_path

string

参数解释:

仓库路径。

取值范围:

无。

secondary_category_type

string

参数解释:

系统预置检视意见分类(废弃字段)。

取值范围:

hicode

secondary_categories

array of categorydto objects

参数解释:

系统预置检视意见。

取值范围:

无。

表6 categorydto

参数

参数类型

描述

key

string

参数解释:

系统预置检视意见分类的key。

取值范围:

无。

name_zh

string

参数解释:

系统预置检视意见分类的中文名。

取值范围:

无。

name_en

string

参数解释:

系统预置检视意见分类的英文名。

取值范围:

无。

sub_categories

array of categorydto objects

参数解释:

系统预置检视意见分类的子分类。

取值范围:

无。

请求示例

get https://{endpoint}/v2/repositories/{repository_id}/review_setting

响应示例

状态码: 200

ok

{
    "result": {
        "categories_and_modules_enabled": true,
        "secondary_category_enabled": false,
        "primary_categories": [
            {
                "key": "realize",
                "name_zh": "算法实现",
                "name_en": "algorithm"
            }
        ],
        "review_default_categories": [
            "realize"
        ],
        "review_customized_categories": [
            "分类"
        ],
        "review_modules": [
            "模块"
        ],
        "source_id": 2111704470,
        "source_type": "project",
        "source_path": "sll_test00006/mr_test"
    },
    "status": "success"
}

状态码

状态码

描述

200

ok

相关文档

网站地图