把外部反馈创建为 Issue
向自己有权限的仓库写入一条问题记录,取得可回填外部系统的编号与链接。
← 返回平台功能接入准备
- 令牌需 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。
调用步骤
- 01
打开 GitHub 头像 → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token,填写用途和到期时间。
- 02
Resource owner 选择仓库所属个人或组织;Repository access 仅选需要接入的仓库。
- 03
Repository permissions 设置 Issues: Read and write。组织要求审批时,等待管理员批准后再读取私有资源。
- 04
生成后复制令牌到 GITHUB_TOKEN;从仓库 URL 提取 GITHUB_OWNER 与 GITHUB_REPO。不要把令牌放进网页源码。
- 05
先在自己的测试仓库编辑标题和正文,再运行示例;此操作会实际创建 Issue 并可能触发通知。
创建 Issue
最小请求仅提供标题和正文;不额外指派人员或添加标签。
https://api.github.com/repos/${GITHUB_OWNER}/${GITHUB_REPO}/issues请求头
Acceptapplication/vnd.github+jsonAuthorizationBearer ${GITHUB_TOKEN}X-GitHub-Api-Version2026-03-10Content-Typeapplication/json
参数说明
参数表可左右滑动,查看完整说明。
| 字段 / 位置 | 类型 / 必填 | 说明 |
|---|---|---|
owner / repoPath | string必填 | 目标仓库所属账号和名称。 |
title请求体 | string必填 | Issue 标题,示例为接入测试文字。 |
body请求体 | string可选 | Markdown 正文;不要放真实密钥或用户敏感数据。 |
调用代码
替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。
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
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 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 供后续查询或页面跳转。 以下为结构示意,非本站实测结果。
{
"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 规则执行。
核验来源
本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。
- 01创建 Fine-grained personal access token核验日期 2026-10-15
- 02REST API 主要与次级限流核验日期 2026-10-15
- 03Create an issue核验日期 2026-10-15