获取企业Issue列表

POST 
/api/v8/enterprises/:enterprise_id/issues

Request

Path Parameters

enterprise_id stringrequired

企业id

Query Parameters

access_token stringrequired

用户授权码

application/json

Body

pageinteger
当前的页码:默认为 1
per_pageinteger
每页的数量，最大为 100，默认 20
labelsstring
标签，多个按英文逗号隔开
sortstring
排序依据: 创建时间(created)，更新时间(updated_at)。默认: created_at
directionstring
排序方式: 升序(asc)，降序(desc)。默认: desc
sincestring
起始的更新时间，要求时间格式为 ISO 8601
assigneesstring[]
负责人的用户名
milestone_idsinteger[]
企业里程碑id
project_idsinteger[]
项目id
create_atstring
任务创建日期，格式2024-11-09
created_beforestring
任务创建截止时间，格式2024-11-09
searchstring
通过关键字搜索issue标题
issue_typesstring[]
issue自定义类型
issue_statesstring[]
issue自定义状态
custom_fields object[]
Array [
field_namestring
valuesstring[]
operationstringrequired
操作类型，可选值：search（模糊搜索）, greater_equal（大于等于）, less_equal（小于等于）, between（在什么之间）, in（精确匹配）
]

Responses

200

成功响应

Response Headers

total_count

总数量

total_page

总页数

application/json

Schema

Schema

Array [
idinteger
id
html_urlstring
numberstring
statestring
titlestring
bodystring
user object
作者
idstringrequired
object_idstringrequired
loginstringrequired
namestringrequired
repository object
仓库信息
idintegerrequired
full_namestringrequired
human_namestringrequired
pathstringrequired
namestringrequired
urlstringrequired
assigner objectrequired
object
paasstringrequired
created_atstring
updated_atstring
finished_atstring
deadlinestring
labels object[]
Array [
idintegerrequired
namestringrequired
colorstringrequired
]
issue_statestring
issue自定义状态
commentsinteger
custom_fields object[]
issue自定义字段
Array [
field_namestringrequired
field_valuesstring[]required
]
issue_typestring
issue类型
issue_prioritystring
issue优先级
urlstring
repository_urlstring
visibility_reasonstring
可见性，public：公开可见，confidential：私密，项目成员可见，other：其他原因导致的仅项目成员可见
related_branchesstring[]
关联的分支列表
linked_pulls object[]
关联的pull_request列表
Array [
numberintegerrequired
html_urlstringrequired
user objectrequired
idstringrequired
loginstringrequired
namestringrequired
avatar_urlstringrequired
html_urlstringrequired
idintegerrequired
project_idintegerrequired
titlestringrequired
bodystringrequired
statestringrequired
created_atstringrequired
updated_atstringrequired
merged_atstringrequired
merged_by objectrequired
idstringrequired
loginstringrequired
namestringrequired
avatar_urlstringrequired
html_urlstringrequired
closed_atstringrequired
target_branchstringrequired
source_branchstringrequired
source_project_idintegerrequired
target_project_idintegerrequired
]
]

Example (auto)

[
  {
    "id": 0,
    "html_url": "string",
    "number": "string",
    "state": "string",
    "title": "string",
    "body": "string",
    "user": {
      "id": "string",
      "object_id": "string",
      "login": "string",
      "name": "string"
    },
    "repository": {
      "id": 0,
      "full_name": "string",
      "human_name": "string",
      "path": "string",
      "name": "string",
      "url": "string",
      "assigner": {},
      "paas": "string"
    },
    "created_at": "string",
    "updated_at": "string",
    "finished_at": "string",
    "deadline": "string",
    "labels": [
      {
        "id": 0,
        "name": "string",
        "color": "string"
      }
    ],
    "issue_state": "string",
    "comments": 0,
    "custom_fields": [
      {
        "field_name": "string",
        "field_values": [
          "string"
        ]
      }
    ],
    "issue_type": "string",
    "issue_priority": "string",
    "url": "string",
    "repository_url": "string",
    "visibility_reason": "string",
    "related_branches": [
      "string"
    ],
    "linked_pulls": [
      {
        "number": 0,
        "html_url": "string",
        "user": {
          "id": "string",
          "login": "string",
          "name": "string",
          "avatar_url": "string",
          "html_url": "string"
        },
        "id": 0,
        "project_id": 0,
        "title": "string",
        "body": "string",
        "state": "string",
        "created_at": "string",
        "updated_at": "string",
        "merged_at": "string",
        "merged_by": {
          "id": "string",
          "login": "string",
          "name": "string",
          "avatar_url": "string",
          "html_url": "string"
        },
        "closed_at": "string",
        "target_branch": "string",
        "source_branch": "string",
        "source_project_id": 0,
        "target_project_id": 0
      }
    ]
  }
]

1

成功示例

{
  "id": 48,
  "name": "多选下拉",
  "description": "",
  "field_type": "select_multi",
  "field_visibility": 0,
  "created_time": "2025-12-18T14:50:25+08:00",
  "updated_time": "2025-12-18T14:50:25+08:00",
  "options": [
    {
      "id": 51,
      "extend_field_id": 48,
      "sort_num": 9999,
      "field_value": "1",
      "created_time": "2025-12-18T14:50:34+08:00",
      "updated_time": "2025-12-18T14:50:34+08:00"
    },
    {
      "id": 52,
      "extend_field_id": 48,
      "sort_num": 9999,
      "field_value": "2",
      "created_time": "2025-12-18T14:50:36+08:00",
      "updated_time": "2025-12-18T14:50:36+08:00"
    },
    {
      "id": 53,
      "extend_field_id": 48,
      "sort_num": 9999,
      "field_value": "3",
      "created_time": "2025-12-18T14:50:38+08:00",
      "updated_time": "2025-12-18T14:50:38+08:00"
    },
    {
      "id": 54,
      "extend_field_id": 48,
      "sort_num": 9999,
      "field_value": "4",
      "created_time": "2025-12-18T14:50:41+08:00",
      "updated_time": "2025-12-18T14:50:41+08:00"
    }
  ],
  "types": [
    {
      "id": 425,
      "name": "需求",
      "desc": "",
      "enabled": true,
      "sort_num": 1,
      "kind": 0
    }
  ]
}

2

成功示例

{
  "id": 47,
  "name": "test3",
  "description": "",
  "field_type": "select_single",
  "field_visibility": 1,
  "created_time": "2025-12-18T10:58:24+08:00",
  "updated_time": "2025-12-18T10:58:24+08:00",
  "options": [
    {
      "id": 49,
      "extend_field_id": 47,
      "sort_num": 9999,
      "field_value": "1",
      "created_time": "2025-12-18T10:58:58+08:00",
      "updated_time": "2025-12-18T10:58:58+08:00"
    },
    {
      "id": 50,
      "extend_field_id": 47,
      "sort_num": 9999,
      "field_value": "2",
      "created_time": "2025-12-18T10:59:02+08:00",
      "updated_time": "2025-12-18T10:59:02+08:00"
    }
  ],
  "types": [
    {
      "id": 425,
      "name": "需求",
      "desc": "",
      "enabled": true,
      "sort_num": 1,
      "kind": 0
    }
  ]
}

3

成功示例

{
  "id": 46,
  "name": "test2",
  "description": "1",
  "field_type": "text_single",
  "field_visibility": 1,
  "created_time": "2025-12-18T10:57:54+08:00",
  "updated_time": "2025-12-18T10:57:54+08:00",
  "types": []
}

4

成功示例

{
  "id": 45,
  "name": "test1",
  "description": "",
  "field_type": "text_single",
  "field_visibility": 0,
  "created_time": "2025-12-18T10:46:51+08:00",
  "updated_time": "2026-01-07T09:22:17+08:00",
  "types": [
    {
      "id": 425,
      "name": "需求",
      "desc": "",
      "enabled": true,
      "sort_num": 1,
      "kind": 0
    }
  ]
}