获取企业Issue列表¶

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "page": {
      "description": "当前的页码，默认 1",
      "type": "integer",
      "default": 1
    },
    "per_page": {
      "description": "每页的数量，最大为 100，默认 20",
      "type": "integer",
      "default": 20,
      "maximum": 100
    },
    "labels": {
      "description": "标签，多个按英文逗号隔开",
      "type": "string"
    },
    "sort": {
      "description": "排序依据：created（创建时间）、updated_at（更新时间），默认 created_at",
      "type": "string",
      "enum": ["created", "updated_at"],
      "default": "created_at"
    },
    "direction": {
      "description": "排序方式：asc（升序）、desc（降序），默认 desc",
      "type": "string",
      "enum": ["asc", "desc"],
      "default": "desc"
    },
    "since": {
      "description": "起始的更新时间，要求时间格式为 ISO 8601",
      "type": "string",
      "format": "date-time"
    },
    "assignees": {
      "description": "负责人的用户名",
      "type": "array",
      "items": {"type": "string"}
    },
    "milestone_ids": {
      "description": "企业里程碑id",
      "type": "array",
      "items": {"type": "integer"}
    },
    "project_ids": {
      "description": "项目id",
      "type": "array",
      "items": {"type": "integer"}
    },
    "create_at": {
      "description": "任务创建日期，格式 2024-11-09",
      "type": "string",
      "format": "date"
    },
    "created_before": {
      "description": "任务创建截止时间，格式 2024-11-09",
      "type": "string",
      "format": "date"
    },
    "search": {
      "description": "通过关键字搜索 issue 标题",
      "type": "string"
    },
    "issue_types": {
      "description": "issue 自定义类型",
      "type": "array",
      "items": {"type": "string"}
    },
    "issue_states": {
      "description": "issue 自定义状态",
      "type": "array",
      "items": {"type": "string"}
    },
    "custom_fields": {
      "description": "自定义字段过滤条件",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field_name": {
            "description": "字段名",
            "type": "string"
          },
          "values": {
            "description": "字段值列表",
            "type": "array",
            "items": {"type": "string"}
          },
          "operation": {
            "description": "操作类型：search（模糊搜索）、greater_equal（大于等于）、less_equal（小于等于）、between（在什么之间）、in（精确匹配）",
            "type": "string",
            "enum": ["search", "greater_equal", "less_equal", "between", "in"]
          }
        },
        "required": ["operation"]
      }
    }
  },
  "required": []
}

{
  "error": "unauthorized",
  "message": "缺少或无效的访问令牌"
}

{
  "error": "forbidden",
  "message": "没有权限访问该企业的 Issue 列表"
}

curl -X POST 'https://api.atomgit.com/api/v8/enterprises/<enterprise_id>/issues?access_token=<token>' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  -d '{
    "page": 1,
    "per_page": 20,
    "labels": "bug,ui",
    "sort": "created",
    "direction": "desc",
    "search": "登录"
  }'

// 原生 fetch (Node.js 18+ / 浏览器)
const response = await fetch(
  "https://api.atomgit.com/api/v8/enterprises/<enterprise_id>/issues?access_token=<token>",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "Accept": "application/json"
    },
    body: JSON.stringify({
      page: 1,
      per_page: 20,
      labels: "bug,ui",
      sort: "created",
      direction: "desc",
      search: "登录"
    })
  }
);

if (!response.ok) {
  throw new Error(`请求失败: ${response.status}`);
}

const data = await response.json();
console.log(data);

import requests

resp = requests.post(
    "https://api.atomgit.com/api/v8/enterprises/<enterprise_id>/issues",
    params={"access_token": "<token>"},
    json={
        "page": 1,
        "per_page": 20,
        "labels": "bug,ui",
        "sort": "created",
        "direction": "desc",
        "search": "登录"
    },
    headers={"Accept": "application/json"},
    timeout=10,
)
resp.raise_for_status()

print(resp.json())

[
  {
    "id": 12,
    "html_url": "https://api.atomgit.com/enterprises/example/issues/12",
    "number": "12",
    "state": "open",
    "title": "登录页样式优化",
    "body": "修复登录页在移动端下的样式问题",
    "user": {
      "id": "10001",
      "object_id": "a1b2c3d4",
      "login": "octocat",
      "name": "Octo Cat"
    },
    "repository": {
      "id": 100,
      "full_name": "example/repo",
      "human_name": "示例仓库",
      "path": "example/repo",
      "name": "repo",
      "url": "https://api.atomgit.com/example/repo",
      "assigner": {},
      "paas": "gitcode"
    },
    "created_at": "2026-10-01T10:00:00+08:00",
    "updated_at": "2026-10-05T10:00:00+08:00",
    "finished_at": null,
    "deadline": null,
    "labels": [
      {
        "id": 1,
        "name": "bug",
        "color": "#d73a4a"
      }
    ],
    "issue_state": "进行中",
    "comments": 3,
    "custom_fields": [
      {
        "field_name": "优先级",
        "field_values": ["高"]
      }
    ],
    "issue_type": "需求",
    "issue_priority": "高",
    "url": "https://api.atomgit.com/api/v8/enterprises/example/issues/12",
    "repository_url": "https://api.atomgit.com/example/repo",
    "visibility_reason": "public",
    "related_branches": ["feature/login"],
    "linked_pulls": [
      {
        "number": 88,
        "html_url": "https://api.atomgit.com/example/repo/pulls/88",
        "user": {
          "id": "10001",
          "login": "octocat",
          "name": "Octo Cat",
          "avatar_url": "https://api.atomgit.com/avatar.png",
          "html_url": "https://api.atomgit.com/octocat"
        },
        "id": 88,
        "project_id": 100,
        "title": "优化登录页样式",
        "body": "修复移动端样式",
        "state": "merged",
        "created_at": "2026-10-02T10:00:00+08:00",
        "updated_at": "2026-10-03T10:00:00+08:00",
        "merged_at": "2026-10-04T10:00:00+08:00",
        "merged_by": {
          "id": "10001",
          "login": "octocat",
          "name": "Octo Cat",
          "avatar_url": "https://api.atomgit.com/avatar.png",
          "html_url": "https://api.atomgit.com/octocat"
        },
        "closed_at": "2026-10-04T10:00:00+08:00",
        "target_branch": "main",
        "source_branch": "feature/login",
        "source_project_id": 100,
        "target_project_id": 100
      }
    ]
  }
]