创建Issue¶

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "repo": {
      "description": "仓库路径",
      "type": "string"
    },
    "title": {
      "description": "Issue标题",
      "type": "string"
    },
    "body": {
      "description": "Issue描述",
      "type": "string"
    },
    "assignee": {
      "description": "Issue负责人的username，多个用英文逗号隔开",
      "type": "string"
    },
    "milestone": {
      "description": "里程碑序号",
      "type": "integer"
    },
    "labels": {
      "description": "用逗号分开的标签，名称要求长度在 2-20 之间且非特殊字符。如: bug,performance",
      "type": "string"
    },
    "security_hole": {
      "description": "是否是私有issue(默认为false)",
      "type": "string"
    },
    "template_path": {
      "description": "issue模板路径，项目模板支持.gitcode，.github，.gitee目录下的文件，组织模板仅支持.gitcode项目下的.gitcode目录下的文件",
      "type": "string"
    },
    "issue_type": {
      "description": "issue类型（企业版支持），设置值需与企业issue高级功能中的设置保持一致",
      "type": "string"
    },
    "issue_severity": {
      "description": "issue优先级（企业版支持），设置值需与企业issue高级功能中的设置保持一致",
      "type": "string"
    },
    "custom_fields": {
      "description": "自定义字段信息（企业版支持）",
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "field_name": {
            "description": "字段名称",
            "type": "string"
          },
          "field_values": {
            "description": "字段的值数组",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  },
  "required": ["repo", "title", "body"]
}

{
  "error": "invalid_request",
  "message": "参数 title 不能为空"
}

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

curl -X POST 'https://api.atomgit.com/api/v5/repos/<owner>/issues?access_token=<token>' \
  -H 'Content-Type: application/json' \
  -d '{
    "repo": "<repo>",
    "title": "<issue title>",
    "body": "<issue description>",
    "assignee": "user1,user2",
    "milestone": 3,
    "labels": "bug,performance",
    "security_hole": "false"
  }'

// 原生 fetch (Node.js 18+ / 浏览器)
const response = await fetch("https://api.atomgit.com/api/v5/repos/<owner>/issues?access_token=<token>", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
    repo: "<repo>",
    title: "<issue title>",
    body: "<issue description>",
    assignee: "user1,user2",
    labels: "bug,performance",
  }),
});

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/v5/repos/<owner>/issues",
    params={"access_token": "<token>"},
    json={
        "repo": "<repo>",
        "title": "<issue title>",
        "body": "<issue description>",
        "assignee": "user1,user2",
        "labels": "bug,performance",
    },
    timeout=10,
)
resp.raise_for_status()

print(resp.json())

{
  "id": 152642,
  "html_url": "https://api.atomgit.com/dengmengmian/test01/issues/15",
  "number": 15,
  "state": "opened",
  "title": "半月据",
  "body": "节油料被引系活力级少本化段维家住实。",
  "user": {
    "avatar_url": "https://api.atomgit.com/avatars/dengmengmian.png",
    "html_url": "https://api.atomgit.com/dengmengmian",
    "id": "661ce4eab470b1430d456154",
    "login": "dengmengmian",
    "name": "麻凡_"
  },
  "assignee": null,
  "repository": {
    "id": 152642,
    "full_name": "dengmengmian/test01",
    "path": "test01",
    "name": "test01",
    "description": "",
    "created_at": "2024-04-18T14:35:15.479+08:00",
    "updated_at": "2024-04-18T14:35:15.479+08:00"
  },
  "created_at": "2024-04-18T14:35:15.479+08:00",
  "updated_at": "2024-04-18T14:35:15.479+08:00",
  "finished_at": null,
  "labels": [
    {
      "id": 382379,
      "name": "enim",
      "color": "#428BCA"
    },
    {
      "id": 382378,
      "name": "proident",
      "color": "#428BCA"
    }
  ],
  "stage": "New",
  "severity": "Major"
}