九游平台/ 代码托管 codearts repo/ api参考/ / / 获取仓库合并请求列表
更新时间：2024-11-08 gmt 08:00

获取仓库合并请求列表-九游平台

功能介绍

获取仓库的合并请求列表

调试

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

uri

get /v2/repositories/{repository_id}/merge_request

表1 路径参数

参数

是否必选

参数类型

描述

repository_id

是

integer

参数解释：

仓库短id，对应产品界面的“repository id”。

约束限制：

必传。

取值范围：

0-2147483647

默认取值：

不涉及。
表2 query参数

参数

是否必选

参数类型

描述

state

否

string

参数解释：

合并请求状态。

约束限制：

无。

取值范围：

取值为以下类型中的一种：

opened : 开启中的合并请求。

closed：已关闭的合并请求。

merged：已合并的合并请求。

locked：已锁定的合并请求。

all：所有状态的合并请求。

默认取值：

all：所有状态的合并请求

page

否

string

参数解释：

分页页数。

约束限制：

不涉及。

取值范围：

正整数范围内的有效页数。

默认取值：

1

per_page

否

integer

参数解释：

分页大小。

约束限制：

不涉及。

取值范围：

0-2147483647

默认取值：

20

search

否

string

参数解释：

搜索合并中标题或描述包含的字符串。

约束限制：

不涉及。

取值范围：

字符串长度范围为[0,100]。

默认取值：

不涉及。

请求参数

表3 请求header参数

参数

是否必选

参数类型

描述

x-auth-token

是

string

参数解释：

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

约束限制：

必传。

取值范围：

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

默认取值：

不涉及。

响应参数

状态码： 200

表4 响应body参数

参数

参数类型

描述

error

error object

参数解释：

响应错误码。

result

mergeresult object

参数解释：

响应结果。

status

string

参数解释：

调用此接口的响应状态。

取值范围：

  • success，表示接口调用成功。
  • failed，表示接口调用失败。
表5 error

参数

参数类型

描述

code

string

参数解释：

错误码。

取值范围：

符合错误码格式字符串，长度[0,100]。

message

string

参数解释：

错误信息。

取值范围：

不涉及。
表6 mergeresult

参数

参数类型

描述

closed

double

参数解释：

已关闭的合并请求数量。

取值范围：

0-2147483647

merge_requests

array of mergerequestsitem objects

参数解释：

合并请求列表详情。

merged

double

参数解释：

已合并的合并请求数量。

取值范围：

0-2147483647

opened

double

参数解释：

开启中的合并请求数量。

取值范围：

0-2147483647

total

double

参数解释：

所有的合并请求数量。

取值范围：

0-2147483647
表7 mergerequestsitem

参数

参数类型

描述

author

author object

参数解释：

合并请求作者信息。

closed_at

string

参数解释：

合并请求的关闭时间。

created_at

string

参数解释：

合并请求的创建时间。

description

string

参数解释：

合并请求的描述信息。

devcloud_source_branch

string

参数解释：

合并请求的源分支名。

id

double

参数解释：

合并请求的id。

取值范围：

0-2147483647

iid

double

参数解释：

当前仓库内合并请求的序列id。

取值范围：

0-2147483647

merge_request_assignee_list

array of author objects

参数解释：

合并请求的检视人信息。

merge_status

string

参数解释：

合并请求是否可以合并。

取值范围：

can_be_merged：可以合并。

cannot_be_merged：不可以合并。

unchecked：未检查。

cannot_be_merged_recheck: 不可合并，检查中。

source_branch

string

参数解释：

合并请求的源分支名。

state

string

参数解释：

合并请求状态。

取值范围：

取值为以下类型中的一种：

opened : 开启中的合并请求。

closed：已关闭的合并请求。

merged：已合并的合并请求。

locked：已锁定的合并请求。

target_branch

string

参数解释：

合并请求的目标分支名。

title

string

参数解释：

合并请求的标题。

updated_at

string

参数解释：

合并请求的最后更新时间。
表8 author

参数

参数类型

描述

id

double

参数解释：

用户id。

name

string

参数解释：

用户名称。

state

string

参数解释：

用户状态。

username

string

参数解释：

用户iam id。

avatar_url

string

参数解释：

头像url。

web_url

string

参数解释：

web url。

请求示例

get https://{endpoint}/v2/repositories/907199/merge_request

响应示例

状态码： 200

ok

{
  "result" : {
    "total" : 1,
    "merge_requests" : [ {
      "iid" : 1,
      "description" : "merge \"branch123\" into \"master\"\n新建文件 dsadsad11",
      "created_at" : "2021-12-08t16:34:49.000 08:00",
      "title" : "tesafrds.",
      "source_branch" : "branch123",
      "updated_at" : "2021-12-08t16:39:24.000 08:00",
      "id" : 6670,
      "state" : "opened",
      "closed_at" : "2021-12-08t16:34:50.000 08:00",
      "author" : {
        "name" : "repo",
        "id" : 1234,
        "state" : "active",
        "username" : "e0c068bf68c44bfab87b763ff85da277"
      },
      "target_branch" : "master",
      "merge_status" : "can_be_merged",
      "devcloud_source_branch" : "branch123",
      "merge_request_assignee_list" : [ {
        "name" : "示例账号",
        "id" : 3333,
        "state" : "active",
        "username" : "a618e34bd5704be3ae3395dfede06041"
      }, {
        "name" : "示例账号",
        "id" : 6747,
        "state" : "active",
        "username" : "42dd0277cfb048dea856e4ee352e937d"
      } ]
    } ],
    "merged" : 0,
    "closed" : 0,
    "opened" : 1
  },
  "status" : "success"
}

状态码

状态码

描述

200

ok

错误码

请参见错误码。

父主题：

相关文档

网站地图