PingCodeRESTAPI
PingCode 官网官方接口文档
PingCode 官网官方接口文档
  1. 拉取请求
  • 概述
  • 鉴权
    • 客户端凭据
      • 获取企业令牌
    • 授权码
      • 登录
      • 请求授权(get_transaction_id)
      • 私有部署-请求授权(get_transaction_id)
      • authorized(get_code)
      • 私有部署-authorized(get_code) 
      • 获取用户令牌 (Get token)
      • 刷新用户令牌 (Refresh_access_token)
  • 全局
    • 个人
      • 获取个人基本信息
    • 组织
      • 企业
        • 获取企业信息
      • 企业成员
        • 创建一个企业成员
        • 部分更新一个企业成员
        • 批量更新企业成员属性
        • 获取企业成员列表
        • - 获取一个企业成员
      • 部门
        • 创建一个部门
        • 部分更新一个部门
        • 获取部门列表
        • - 获取一个部门
        • 删除一个部门
      • 团队
        • 创建一个团队
        • 部分更新一个团队
        • 获取团队列表
        • - 获取一个团队
        • 添加一个团队成员
        • 获取团队成员列表
        • - 获取一个团队成员
        • 移除一个团队成员
      • 角色
        • 获取角色列表
        • - 获取一个角色
      • 职位
        • 获取职位列表
        • - 获取一个职位
    • 安全
      • 日志
        • 获取登录日志列表
        • 获取审计日志列表
    • 通用
      • 评论
        • 创建一个评论
        • 获取评论列表
        • - 获取一个评论
        • 删除一个评论
      • 附件
        • 上传一个附件
        • 上传一个代码段
        • 获取附件列表
        • - 获取一个附件
        • 删除一个附件
      • 关注人
        • 添加一个关注人
        • 获取关注人列表
        • - 获取一个关注人
        • 移除一个关注人
      • 关联
        • 创建一个关联
        • 获取关联列表
        • - 获取一个关联
        • 删除一个关联
      • 工时
        • 创建一个工时
        • 部分更新一个工时
        • 获取工时列表
        • - 获取一个工时
        • 删除一个工时
        • 获取工时类型列表
        • - 获取一个工时类型
  • 产品管理 Product
    • 产品
      • 创建一个产品
      • 部分更新一个产品
      • 获取产品列表
      •  -获取一个产品
      • 获取产品中的需求排期列表
      •  - 获取产品中的一个需求排期
      • 获取产品中工单渠道列表
      •  - 获取产品中一个工单渠道
      • 获取产品中工单类型列表
      • - 获取产品中工单一个类型列表
      • 获取产品中的标签列表
      • - 获取产品中的一个标签
    • 客户
      • 创建一个客户
      • 部分更新一个客户
      • 获取客户列表
      • - 获取一个客户
    • 工单
      • 创建一个工单
      • 部分更新一个工单
      • 获取工单列表
      • - 获取一个工单
      • 获取工单类型列表
      • - 获取一个工单类型
      • 获取工单状态列表
      • - 获取一个工单状态
      • 获取工单属性列表
      • - 获取一个工单属性
      • 获取工单渠道列表
      • - 获取工单一个渠道
      • 获取工单优先级列表
      • - 获取工单一个优先级
      • 获取工单解决方案列表
      • - 获取工单一个解决方案
      • 获取工单标签列表
      • - 获取工单一个标签
      • 获取工单流转记录列表
    • 需求
      • 创建一个需求
      •  部分更新一个需求
      • 获取需求列表
      • - 获取一个需求
      • 获取需求状态列表
      • - 获取需求一个状态
      • 获取需求属性列表
      • - 获取需求一个属性
      • 获取需求模块列表
      • - 获取需求一个模块
      • 获取需求排期列表
      • - 获取需求一个排期
      • 获取需求优先级列表
      • - 获取需求一个优先级
    • 产品配置中心
      • 工单配置
        • 获取全部工单类型列表
        • 创建一个工单状态
        • 部分更新一个工单状态
        • 获取全部工单状态列表
        • 获取工单状态方案列表
        • 向状态方案中添加一个工单状态
        • 获取状态方案中的工单状态列表
        • 在状态方案中移除一个工单状态
        • 向状态方案中添加一个工单状态流转
        • 获取状态方案中的工单状态流转列表
        • 在状态方案中移除一个工单状态流转
        • 创建一个工单属性
        • 部分更新一个工单属性
        • 获取全部工单属性列表
        • 获取工单属性方案列表
        • 向工单属性方案中添加一个工单属性
        • 获取工单属性方案中的工单属性列表
        • - 获取一个工单类型
        • - 获取一个工单状态
        • - 获取一个工单属性
        • 在工单属性方案中移除一个工单属性
      • 需求配置
        • 获取全部需求状态列表
        • - 获取一个需求状态
        • 获取全部需求属性列表
        • - 获取一个需求属性
    • 需求属性
      • 获取一个需求属性
      • 获取需求属性列表
    • 工单优先级
      • 获取一个工单优先级
      • 获取工单优先级列表
    • 需求优先级
      • 获取一个续期优先级
      • 获取需求优先级列表
    • 工单解决方案
      • 获取一个工单解决方案
      • 获取工单解决方案列表
    • 产品成员
      • 获取一个产品成员
    • 产品标签
      • 获取一个产品标签
      • 获取产品标签列表
    • 产品排期
      • 获取一个产品排期
      • 获取产品排期列表
    • 产品模块
      • 获取一个产品模块
      • 获取产品模块列表
    • 工单关注人
      • 获取一个工单关注人
    • 需求关注人
      • 获取一个需求关注人
  • 项目管理 Project
    • 项目
      • 创建一个项目
      • 部分更新一个项目
      • 获取项目列表
      • 获取项目状态列表
      • - 获取一个项目
      • 向项目中添加一个成员
      • 部分更新一个项目内的成员
      • 获取项目中的成员列表
      • - 获取一个项目成员
      • 在项目中移除一个成员
      • 向项目中添加一个项目属性
      • 获取项目中的项目属性列表
      •  - 获取项目中一个项目属性
      • 在项目中移除一个项目属性
      • 获取一个项目的进度
    • Scrum
      • 创建一个迭代
      • 批量创建迭代
      • 部分更新一个迭代
      • 获取迭代列表
      • - 获取一个迭代
      • 创建一个迭代分组
      • 部分更新一个迭代分组
      • 获取迭代分组列表
      • - 获取一个迭代分组
      • 删除一个迭代分组
      • 创建一个迭代类别
      • 部分更新一个迭代类别
      • 获取迭代类别列表
      • - 获取一个迭代类别
      • 删除一个迭代类别
    • Kanban
      • 创建一个看板
      • 部分更新一个看板栏
      • 获取看板列表
      • - 获取一个看板
      • 删除一个看板
      • 创建一个看板栏
      • 部分更新一个看板栏
      • 获取看板栏列表
      • - 获取一个看板栏
      • 删除一个看板栏
      • 创建一个泳道
      • 部分更新一个泳道
      • 获取泳道列表
      • - 获取一个泳道
      • 删除一个泳道
    • 瀑布
      • 向瀑布项目中增加一个工作项类型
      • 获取瀑布项目中的工作项类型列表
      • - 获取瀑布项目中的一个工作项类型
      • 在瀑布项目中移除一个工作项类型
      • 获取工作项流转记录列表
    • 工作项
      • 创建一个工作项
      • 部分更新一个工作项
      • 批量部分更新一个工作项属性
      • 获取工作项列表
      • - 获取一个工作项
      • 删除一个工作项
      • 获取工作项类型列表
      • - 获取一个工作项类型
      • 获取工作项状态列表
      • - 获取一个工作项状态
      • 获取工作项属性列表
      • - 获取一个工作项属性
      • 获取工作项优先级列表
      • - 获取一个工作项优先级
      • 获取工作项标签列表
      • - 获取工作项一个标签
      • 向工作项中添加一个标签
      • 在工作项移除一个标签
      • 关联一个工作项
      • 获取关联的工作项列表
      • 取消关联一个工作项
      • 创建一个工作项交付目标
      • 部分更新一个工作项交付目标
      • 获取工作项交付目标列表
      • - 获取工作项一个交付目标
      • 删除一个工作项交付目标
      • 获取工作项流转记录列表
    • 发布
      • 创建一个发布
      • 批量创建发布
      • 部分更新一个发布
      • 获取发布列表
      • - 获取一个发布
      • 创建一个发布阶段
      • 部分更新一个发布阶段
      • 获取发布阶段列表
      • - 获取一个发布阶段
      • 删除一个发布阶段
      • 创建一个发布分组
      • 部分更新一个发布分组
      • 获取发布分组列表
      • - 获取一个发布分组
      • 删除一个发布分组
      • 创建一个发布类别
      • 部分更新一个发布类别
      • 获取发布类别列表
      • - 获取一个发布类别
      • 删除一个发布类别
    • 项目配置中心
      • 项目配置
        • 创建一个项目属性
        • 部分更新一个项目属性
        • 获取项目属性列表
        • - 获取一个项目属性
      • 工作项配置
        • 创建一个工作项标签
        • 部分更新一个工作项标签
        • 获取全部工作项标签列表
        • 删除一个工作项标签
        • 创建一个工作项类型
        • 部分更新一个工作项类型
        • 获取全部工作项类型列表
        • 删除一个工作项类型
        • 创建一个工作项状态
        • 部分更新一个工作项状态
        • 获取全部工作项状态列表
        • 向状态方案中添加一个工作项状态
        • 获取状态方案中的工作项状态列表
        • 在状态方案中移除一个工作项状态
        • 向状态方案中添加一个工作项状态流转
        • 获取状态方案中的工作项状态流转列表
        • 在状态方案中移除一个工作项状态流转
        • 创建一个工作项属性
        • 部分更新一个工作项属性
        • - 获取一个工作项属性
        • 获取全部工作项属性列表
        • 获取工作项属性方案列表
        • 向属性方案中添加一个工作项属性
        • 获取属性方案中的工作项属性列表
        • 在属性方案中移除一个工作项属性
  • 测试管理 Testhub
    • 测试库
      • 创建一个测试库
      • 部分更新一个测试库
      • 获取测试库列表
      • - 获取一个测试库
      • 向测试库中添加一个成员
      • 获取测试库中的成员列表
      • - 在测试库中获取一个成员
      • 在测试库中移除一个成员
      • 向测试库中添加一个用例模块
      • 部分更新一个测试库中用例模块
      • 获取测试库中的用例模块列表
    • 用例
      • 创建一个测试用例
      • 批量创建测试用例
      • 部分更新一个测试用例
      • 获取测试用例列表
      • - 获取一个测试用例
      • 删除一个测试用例
      • 获取用例模块列表
      • - 获取一个用例模块
      • 获取用例属性列表
      • 获取用例的执行历史列表
      • 批量创建测试用例关联工作项
      • 批量删除测试用例关联工作项
    • 计划
      • 创建一个计划
      • 部分更新一个计划
      • 获取计划列表
      • 获取计划类型列表
      • 创建一个执行用例
      • 批量创建执行用例
      • 全量更新一个执行用例
      • 部分更新一个执行用例
      • 批量部分更新执行用例
      • 批量操作执行用例
      • 获取执行用例列表
      • 获取执行用例的结果记录
    • 配置中心
      • 用例配置
        • 获取全部用例属性列表
        • 获取用例类型列表
        • 获取用例属性方案列表
        • 获取用例属性方案列表
  • 知识管理 Wiki
    • 页面关注人
    • 空间
      • 创建一个空间
      • 部分更新一个空间
      • 获取空间列表
      • - 获取一个空间
      • 删除一个空间
    • 页面
      • 创建一个页面
      • 部分更新一个页面
      • 更新一个文档正文
      • 获取一个文档正文
      • 获取一个页面的版本列表
      • 恢复一个页面到指定版本
      • 获取页面列表
      • 删除一个页面
    • 页面关注人(全局)
      • 获取一个页面关注人
      • 添加一个页面关注人
    • 页面附件(全局)
      • 获取一个页面附件列表
      • 添加一个页面附件
  • DevOps 数据集成
    • 代码
      • 托管平台
        • 创建一个托管平台
        • 全量更新一个托管平台
        • 部分更新一个托管平台
        • 获取一个托管平台
        • 获取托管平台列表
      • 托管平台用户
        • 创建一个托管平台用户
        • 全量更新一个托管平台用户
        • 部分更新一个托管平台用户
        • 获取托管平台用户列表
        • - 获取一个托管平台用户
      • 代码仓库
        • 创建一个代码仓库
        • 全量更新一个代码仓库
        • 部分更新一个代码仓库
        • 获取代码仓库列表
        • - 获取一个代码仓库
      • 代码分支
        • 创建一个代码分支
        • 设置默认代码分支
        • 获取代码分支列表
        • - 获取一个代码分支
        • 删除一个代码分支
      • 提交
        • 创建一个提交
        • 获取提交列表
        • - 获取一个提交
      • 提交引用
        • 创建一个提交引用
        • 获取提交引用列表
        • - 获取一个提交引用
      • 拉取请求
        • 创建一个拉取请求
          POST
        • 全量更新一个拉取请求
          PUT
        • 部分更新一个拉取请求
          PATCH
        • 获取一个拉取请求
          GET
        • 获取拉取请求列表
          GET
      • 代码评审
        • 创建一个代码评审
        • 全量更新一个代码评审
        • 部分更新一个代码评审
        • 获取一个代码评审
        • 获取代码评审列表
    • 构建
      • 构建记录
        • 创建一条构建记录
        • 全量更新一条构建记录
        • 部分更新一条构建记录
        • 获取一条构建记录
        • 获取构建记录列表
        • 删除一条构建记录
    • 交付
      • 环境
        • 创建一个环境
        • 全量更新一个环境
        • 部分更新一个环境
        • 获取一个环境
        • 获取环境列表
        • 删除一个环境
      • 部署
        • 创建一个部署
        • 全量更新一个部署
        • 部分更新一个部署
        • 获取一个部署
        • 获取部署了列表
        • 删除一个部署
  1. 拉取请求

全量更新一个拉取请求

PUT
https://open.pingcode.com/v1/scm/products/{scm_product_id}/repositories/{scm_product_repository_id}/pull_requests/{scm_pull_request_id}
最后修改时间:2024-01-22 09:22:01
责任人:未设置

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Path 参数
scm_product_id
string 
必需
示例值:
{{scm_product_id}}
scm_product_repository_id
string 
必需
示例值:
{{scm_product_repository_id}}
scm_pull_request_id
string 
必需
示例值:
{{scm_pull_request_id}}
Body 参数application/json
title
string 
必需
number
number 
必需
creator_name
string 
必需
description
string 
可选
source_branch_id
string 
可选
target_branch_id
string 
可选
status
string 
可选
merged_at
number 
可选
merged_commit_sha
string 
可选
merged_by_name
string 
可选
comments_count
number 
可选
review_comments_count
number 
可选
commits_count
number 
可选
additions_count
number 
可选
deletions_count
number 
可选
changed_files_count
number 
可选
work_item_identifiers
array[string]
必需
示例
{
    "title": "fix(doc): #PLM-001 fix document title",
    "number": 1,
    "creator_name": "terry",
    "description": "Please give some great suggestions",
    "source_branch_id": "564587fe700d43b81b080767",
    "target_branch_id": "564587fe700d43b81b080776",
    "status": "merged",
    "merged_at": 1473018919,
    "merged_commit_sha": "96a024347146ebdc5f481f45e6e6871e0c43af5f",
    "merged_by_name": "terry",
    "comments_count": 2,
    "review_comments_count": 2,
    "commits_count": 2,
    "additions_count": 0,
    "deletions_count": 0,
    "changed_files_count": 3,
    "work_item_identifiers": [
        "PLM-001"
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request PUT 'https://open.pingcode.com/v1/scm/products/{{scm_product_id}}/repositories/{{scm_product_repository_id}}/pull_requests/{{scm_pull_request_id}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "fix(doc): #PLM-001 fix document title",
    "number": 1,
    "creator_name": "terry",
    "description": "Please give some great suggestions",
    "source_branch_id": "564587fe700d43b81b080767",
    "target_branch_id": "564587fe700d43b81b080776",
    "status": "merged",
    "merged_at": 1473018919,
    "merged_commit_sha": "96a024347146ebdc5f481f45e6e6871e0c43af5f",
    "merged_by_name": "terry",
    "comments_count": 2,
    "review_comments_count": 2,
    "commits_count": 2,
    "additions_count": 0,
    "deletions_count": 0,
    "changed_files_count": 3,
    "work_item_identifiers": [
        "PLM-001"
    ]
}'

返回响应

🟠400请求有误
application/json
Body
id
string 
必需
url
string 
必需
product
object 
必需
id
string 
必需
url
string 
必需
name
string 
必需
type
string 
必需
repository
object 
必需
id
string 
必需
url
string 
必需
name
string 
必需
full_name
string 
必需
created_at
integer 
必需
title
string 
必需
number
integer 
必需
status
string 
必需
description
string 
必需
author
object 
必需
id
string 
必需
url
string 
必需
name
string 
必需
source_branch
object 
必需
id
string 
必需
url
string 
必需
name
string 
必需
create_at
integer 
必需
target_branch
object 
必需
id
string 
必需
url
string 
必需
name
string 
必需
create_at
integer 
必需
created_at
integer 
必需
merged_at
integer 
必需
merged_commit_sha
string 
必需
merged_by
object 
必需
id
string 
必需
url
string 
必需
name
string 
必需
comments_count
integer 
必需
review_comments_count
integer 
必需
commits_count
integer 
必需
additions_count
integer 
必需
deletions_count
integer 
必需
changed_files_count
integer 
必需
work_items
array [object {8}] 
必需
id
string 
可选
url
string 
可选
identifier
string 
可选
title
string 
可选
type
string 
可选
start_at
integer 
可选
end_at
integer 
可选
parent_id
string 
可选
示例
{
    "id": "594587fe700d43b81b080789",
    "url": "https://rest_api_root/v1/scm/products/564587fe700d43b81b080765/repositories/564587fe700d43b81b080766/pull_requests/594587fe700d43b81b080789",
    "product": {
        "id": "564587fe700d43b81b080765",
        "url": "https://rest_api_root/v1/scm/products/564587fe700d43b81b080765",
        "name": "Github",
        "type": "github"
    },
    "repository": {
        "id": "564587fe700d43b81b080766",
        "url": "https://rest_api_root/v1/scm/products/564587fe700d43b81b080765/repositories/564587fe700d43b81b080766",
        "name": "ngx-planet",
        "full_name": "worktile/ngx-planet",
        "created_at": 1403018919
    },
    "title": "fix(doc): #PLM-001 fix document title",
    "number": 1,
    "status": "merged",
    "description": "Please give some great suggestions",
    "author": {
        "id": "5666aea91f99e33cb7c44964",
        "url": "https://rest_api_root/v1/scm/products/564587fe700d43b81b080765/users/5666aea91f99e33cb7c44964",
        "name": "terry"
    },
    "source_branch": {
        "id": "564587fe700d43b81b080767",
        "url": "https://rest_api_root/v1/scm/products/564587fe700d43b81b080765/repositories/564587fe700d43b81b080766/branches/564587fe700d43b81b080767",
        "name": "terry/#PLM-001",
        "create_at": 1403018919
    },
    "target_branch": {
        "id": "564587fe700d43b81b080776",
        "url": "https://rest_api_root/v1/scm/products/564587fe700d43b81b080765/repositories/564587fe700d43b81b080766/branches/564587fe700d43b81b080776",
        "name": "develop",
        "create_at": 1402018919
    },
    "created_at": 1403014000,
    "merged_at": 1473018919,
    "merged_commit_sha": "96a024347146ebdc5f481f45e6e6871e0c43af5f",
    "merged_by": {
        "id": "5666aea91f99e33cb7c44968",
        "url": "https://rest_api_root/v1/scm/products/564587fe700d43b81b080765/users/5666aea91f99e33cb7c44964",
        "name": "terry"
    },
    "comments_count": 2,
    "review_comments_count": 2,
    "commits_count": 2,
    "additions_count": 0,
    "deletions_count": 0,
    "changed_files_count": 3,
    "work_items": [
        {
            "id": "564587fe700d43b81b080ab8",
            "url": "https://rest_api_root/v1/project/work_items/564587fe700d43b81b080ab8",
            "identifier": "PLM-001",
            "title": "这是一个用户故事",
            "type": "story",
            "start_at": 1583290309,
            "end_at": 1583290347,
            "parent_id": "5edca524cad2fa112b06105c"
        }
    ]
}
上一页
创建一个拉取请求
下一页
部分更新一个拉取请求
Built with