GitHub调用手册

把外部反馈创建为 Issue

向自己有权限的仓库写入一条问题记录,取得可回填外部系统的编号与链接。

官方资料核对 2026-10-15示例代码,未进行真实接口实测
← 返回平台功能

接入准备

  • 令牌需 Issues: Write,目标仓库开启 Issues;调用身份有仓库访问权。

准备环境变量

示例值需要替换为自己的凭证或资源 ID。代码在本机或服务端运行;密钥不应放进公开网页。

GITHUB_TOKEN
在 GitHub Settings → Developer settings → Personal access tokens → Fine-grained tokens 创建,仅在本地或服务器设置。
GITHUB_OWNER
仓库 URL 中 github.com/ 后的账号或组织名;虚构值,请替换。
GITHUB_REPO
仓库 URL 中第二段名称,不含 .git;虚构值,请替换。
终端
export GITHUB_TOKEN='github_pat_replace_with_your_token'
export GITHUB_OWNER='example-owner'
export GITHUB_REPO='example-repo'

以上 export 适用于 macOS / Linux 的终端,在同一终端内运行后续代码。Python 示例保存为 request.py 后执行 python3 request.py。

调用步骤

  1. 01

    打开 GitHub 头像 → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token,填写用途和到期时间。

  2. 02

    Resource owner 选择仓库所属个人或组织;Repository access 仅选需要接入的仓库。

  3. 03

    Repository permissions 设置 Issues: Read and write。组织要求审批时,等待管理员批准后再读取私有资源。

  4. 04

    生成后复制令牌到 GITHUB_TOKEN;从仓库 URL 提取 GITHUB_OWNER 与 GITHUB_REPO。不要把令牌放进网页源码。

  5. 05

    先在自己的测试仓库编辑标题和正文,再运行示例;此操作会实际创建 Issue 并可能触发通知。

调用 01

创建 Issue

最小请求仅提供标题和正文;不额外指派人员或添加标签。

POSThttps://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/issues

请求头

Accept
application/vnd.github+json
Authorization
Bearer ${GITHUB_TOKEN}
X-GitHub-Api-Version
2026-03-10
Content-Type
application/json

参数说明

参数表可左右滑动,查看完整说明。

字段 / 位置类型 / 必填说明
owner / repoPathstring必填目标仓库所属账号和名称。
title请求体string必填Issue 标题,示例为接入测试文字。
body请求体string可选Markdown 正文;不要放真实密钥或用户敏感数据。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。

cURL
cat > request-body.json <<'JSON'
{
  "title": "接入测试:反馈同步",
  "body": "这是一条测试反馈,请在测试仓库执行。"
}
JSON

# 执行后核对返回 JSON 的业务状态;HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/issues" \
  --header "Accept: application/vnd.github+json" \
  --header "Authorization: Bearer ${GITHUB_TOKEN}" \
  --header "X-GitHub-Api-Version: 2026-03-10" \
  --header "Content-Type: application/json" \
  --data-binary @request-body.json
Python 3
import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/issues")
headers = {
    "Accept": expand("application/vnd.github+json"),
    "Authorization": expand("Bearer ${GITHUB_TOKEN}"),
    "X-GitHub-Api-Version": expand("2026-03-10"),
    "Content-Type": expand("application/json"),
}
body = {
    "title": "接入测试:反馈同步",
    "body": "这是一条测试反馈,请在测试仓库执行。",
}
data = json.dumps(body, ensure_ascii=False).encode("utf-8")
request = urllib.request.Request(url, data=data, headers=headers, method="POST")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
Node.js
// Node.js 22+,保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/issues");
const headers = Object.fromEntries(
  Object.entries({
  "Accept": "application/vnd.github+json",
  "Authorization": "Bearer ${GITHUB_TOKEN}",
  "X-GitHub-Api-Version": "2026-03-10",
  "Content-Type": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const body = {
  "title": "接入测试:反馈同步",
  "body": "这是一条测试反馈,请在测试仓库执行。"
};
const response = await fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(body),
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));

返回示例

按官方字段整理的响应结构示意,ID、文本和数字均为虚构,非接口实测结果。保存 number 和 html_url 供后续查询或页面跳转。 以下为结构示意,非本站实测结果。

JSON
{
  "id": 100000001,
  "number": 42,
  "state": "open",
  "title": "接入测试:反馈同步",
  "body": "这是一条测试反馈,请在测试仓库执行。",
  "html_url": "https://github.com/example-owner/example-repo/issues/42"
}

常见错误与排查

HTTP 403访问被拒绝,也可能触发限流。
先核对令牌权限和仓库范围;检查 x-ratelimit-remaining、x-ratelimit-reset 或 retry-after,再决定何时重试。
HTTP 404未找到资源或调用身份看不到目标资源。
检查仓库、路径拼写以及组织审批状态;不要据此断言私有仓库不存在。
HTTP 410仓库未启用 Issues。
让仓库管理员在设置中开启 Issues,或改用已启用的测试仓库。
HTTP 422字段验证失败或被判定为垃圾内容。
检查标题、参数格式与重复创建频率;不要无条件重试写操作。

调用注意

  • 成功状态为 HTTP 201。请求超时后先检查是否已创建,重复提交会再生成一条 Issue。
  • 创建内容过快可触发次级限流;批量同步应排队并做好外部记录与 Issue 编号的映射。

注意事项

  • 个人令牌通常共用每小时 5,000 次的主额度;次级限流仍可提前触发。公开读取不携带令牌时通常为每 IP 每小时 60 次。
  • 本例不运行 Actions、不上传付费存储;账号套餐、仓库功能及 API 配额仍按 GitHub 规则执行。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

  1. 01
  2. 02
    REST API 主要与次级限流核验日期 2026-10-15
  3. 03
    Create an issue核验日期 2026-10-15

GitHub的其他调用手册

← 返回GitHub的全部功能