部分更新一个工单 - PingCodeRESTAPI

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

ticket_id

string

必需

示例值:

Body 参数application/json

title

string

可选

工单的标题，最大长度为255。

description

string

工单的描述。

可选

type_id

string

可选

工单的类型id，您可以在 “获取工单类型列表” API获取。

state_id

string

可选

工单的状态id，您可以在 “获取工单状态列表” API获取。

assignee_id

string

工单的负责人id。

可选

submitter_id

string

可选

工单的提交人id，企业授权时，该值有效；个人鉴权时，指定无效。

solution_id

string

可选

工单的解决方案id，您可以在 “获取工单解决方案列表” API获取。

priority_id

string

可选

工单的优先级id，您可以在 “获取工单优先级列表” API获取。

customer_id

string

可选

工单的客户id，您可以在 “获取产品客户列表” API获取。

properties

object

工单的自定义属性。

可选

prop_a

object

可选

工单的自定义属性prop_a。

prop_b

object

可选

工单的自定义属性prop_b。

示例

{
  "title": "希望新增支持第三方账号注册",
  "description": "<p>希望支持其他更多第三方平台的账号注册，以便用第三方账号登录找回更换了手机号的账号，保障账号安全</p>",
  "type_id": "63eca880a0a13a3efc8d49e0",
  "state_id": "63eca880a0a13a3efc8d49e0",
  "assignee_id": "a0417f68e846aae315c85d24643678a9",
  "submitter_id": "a0417f68e846aae315c85d24643678a9",
  "solution_id": "62f217ae16e3661a20124330",
  "priority_id": "5cb9466afda1ce4ca0090004",
  "customer_id": "63eca881a0a13a3efc8d49fc",
  "properties": {
    "prop_a": "prop_a_value",
    "prop_b": "prop_b_value"
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location -g --request PATCH 'https://open.pingcode.com/v1/ship/tickets/{ticket_id}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "title": "希望新增支持第三方账号注册",
    "description": "<p>希望支持其他更多第三方平台的账号注册，以便用第三方账号登录找回更换了手机号的账号，保障账号安全</p>",
    "type_id": "63eca880a0a13a3efc8d49e0",
    "state_id": "63eca880a0a13a3efc8d49e0",
    "assignee_id": "a0417f68e846aae315c85d24643678a9",
    "submitter_id": "a0417f68e846aae315c85d24643678a9",
    "solution_id": "62f217ae16e3661a20124330",
    "priority_id": "5cb9466afda1ce4ca0090004",
    "customer_id": "63eca881a0a13a3efc8d49fc",
    "properties": {
        "prop_a": "prop_a_value",
        "prop_b": "prop_b_value"
    }
}'

返回响应

🟢200成功

application/json

Body

id

string

必需

url

string

必需

product

object

必需

id

string

必需

url

string

必需

identifier

string

必需

name

string

必需

identifier

string

必需

title

string

必需

assignee

object

必需

id

string

必需

url

string

必需

name

string

必需

display_name

string

必需

avatar

string

必需

state

object

必需

id

string

必需

url

string

必需

name

string

必需

type

string

必需

type

object

必需

id

string

必需

url

string

必需

name

string

必需

customer

object

必需

id

string

必需

url

string

必需

name

string

必需

solution

object

必需

id

string

必需

url

string

必需

name

string

必需

priority

object

必需

id

string

必需

url

string

必需

name

string

必需

channel

object

必需

id

string

必需

url

string

必需

name

string

必需

description

string

必需

properties

object

必需

prop_a

string

必需

prop_b

string

必需

participants

array [object {5}]

必需

id

string

必需

url

string

必需

type

string

必需

user

object

可选

user_group

object

可选

submitted_at

integer

必需

submitted_by

object

必需

id

string

必需

url

string

必需

name

string

必需

display_name

string

必需

avatar

string

必需

created_at

integer

必需

created_by

object

必需

id

string

必需

url

string

必需

name

string

必需

display_name

string

必需

avatar

string

必需

updated_at

integer

必需

updated_by

object

必需

id

string

必需

url

string

必需

name

string

必需

display_name

string

必需

avatar

string

必需

is_archived

integer

必需

is_deleted

integer

必需

示例

{
  "id": "63eca888a0a13a3efc8d4a43",
  "url": "https://rest_api_root/v1/ship/tickets/63eca888a0a13a3efc8d4a43",
  "product": {
    "id": "6422711c3f12e6c1e46d40e9",
    "url": "https://rest_api_root/v1/ship/products/6422711c3f12e6c1e46d40e9",
    "identifier": "SLC",
    "name": "示例产品"
  },
  "identifier": "SLC-T1",
  "title": "希望新增支持第三方账号注册",
  "assignee": {
    "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"
  },
  "state": {
    "id": "63eca880a0a13a3efc8d49d9",
    "url": "https://rest_api_root/v1/ship/ticket_states/63eca880a0a13a3efc8d49d9",
    "name": "待处理",
    "type": "pending"
  },
  "type": {
    "id": "63eca880a0a13a3efc8d49e0",
    "url": "https://rest_api_root/v1/ship/ticket_types/63eca880a0a13a3efc8d49e0",
    "name": "需求"
  },
  "customer": {
    "id": "63eca881a0a13a3efc8d49fc",
    "url": "https://rest_api_root/v1/ship/products/6422711c3f12e6c1e46d40e9/customers/63eca881a0a13a3efc8d49fc",
    "name": "北京XX科技有限公司"
  },
  "solution": {
    "id": "62f217ae16e3661a20124330",
    "url": "https://rest_api_root/v1/ship/ticket_solutions/62f217ae16e3661a20124330",
    "name": "进入需求池"
  },
  "priority": {
    "id": "5cb9466afda1ce4ca0090004",
    "url": "https://rest_api_root/v1/ship/ticket_priorities/5cb9466afda1ce4ca0090004",
    "name": "P1"
  },
  "channel": {
    "id": "64550d9ec696b249b5fc607d",
    "url": "https://rest_api_root/v1/ship/channels/64550d9ec696b249b5fc607d",
    "name": "channel-1"
  },
  "description": "<p>希望支持其他更多第三方平台的账号注册，以便用第三方账号登录找回更换了手机号的账号，保障账号安全</p>",
  "properties": {
    "prop_a": "prop_a_value",
    "prop_b": "prop_b_value"
  },
  "participants": [
    {
      "id": "a0417f68e846aae315c85d24643678a9",
      "url": "https://rest_api_root/v1/ship/tickets/63eca888a0a13a3efc8d4a43/participants/a0417f68e846aae315c85d24643678a9",
      "type": "user",
      "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"
      }
    },
    {
      "id": "63c8fb32729dee3334d96af7",
      "url": "https://rest_api_root/v1/ship/tickets/63eca888a0a13a3efc8d4a43/participants/63c8fb32729dee3334d96af7",
      "type": "user_group",
      "user_group": {
        "id": "63c8fb32729dee3334d96af7",
        "url": "https://rest_api_root/v1/directory/groups/63c8fb32729dee3334d96af7",
        "name": "Open Team"
      }
    }
  ],
  "submitted_at": 1676454024,
  "submitted_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"
  },
  "created_at": 1676454024,
  "created_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"
  },
  "updated_at": 1676455024,
  "updated_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"
  },
  "is_archived": 0,
  "is_deleted": 0
}