本教程详细介绍了如何利用GitHub REST API通过编程方式创建新的GitHub仓库。文章将引导读者生成个人访问令牌（PAT），配置必要的API请求（包括端点、HTTP方法、授权头和请求体），并提供一个基于Java的实际代码示例，以实现自动化仓库创建。通过遵循本指南，开发者可以轻松地将GitHub仓库创建功能集成到其应用程序中，提高工作效率。
在现代软件开发流程中，自动化任务是提高效率的关键。其中，通过编程方式创建GitHub仓库是持续集成/持续部署（CI/CD）流程、项目管理工具或自定义脚本中常见的需求。虽然JGit、hub、gh等工具提供了命令行或库级别的支持，但GitHub REST API提供了一种更直接、更灵活的方式来与GitHub服务进行交互。本教程将专注于使用GitHub REST API，并提供Java语言的实现示例。
为了通过API对GitHub进行身份验证并执行操作，您需要一个个人访问令牌（PAT）。PAT是您的GitHub账户的替代密码，它允许您在不暴露主密码的情况下，授权应用程序或脚本访问您的GitHub资源。
生成步骤：
安全注意事项：
创建仓库的API端点是针对已认证用户操作的，需要一个 POST 请求。
API 端点：
https://api.github.com/user/repos
HTTP 方法：
POST
请求头 (Headers)：
您必须在请求头中包含授权信息。
请求体 (Body)：
请求体是一个JSON对象，至少需要包含新仓库的名称。
{
"name": "YOUR_REPO_NAME",
"description": "Optional description for your repository",
"homepage": "https://github.com",
"private": false, // true for private, false for public
"has_issues": true,
"has_projects": true,
"has_wiki": true
}您可以根据需要添加其他字段，例如 description (描述), private (私有/公开), auto_init (是否自动初始化 README 文件) 等。
Curl 示例：
这是一个使用 curl 命令进行API调用的示例：
curl -X POST \
-H "Authorization: token YOUR_PERSONAL_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
https://api.github.com/user/repos \
-d '{"name": "MyNewJavaRepo", "description": "A repository created programmatically with Java", "private": false}'以下是使用Java 11+ java.net.http.HttpClient 来实现编程创建GitHub仓库的示例。
import java.io.IOException;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.nio.charset.StandardCharsets;
public class GitHubRepoCreator {
// 替换为您的个人访问令牌
private static final String GITHUB_PAT = "YOUR_PERSONAL_ACCESS_TOKEN";
// 替换为您希望创建的仓库名称
private static final String REPO_NAME = "MyProgrammaticRepo";
// 替换为仓库描述 (可选)
private static final String REPO_DESCRIPTION = "A repository created via Java program.";
// 设置为 true 创建私有仓库，false 创建公共仓库
private static final boolean IS_PRIVATE = false;
public static void main(String[] args) {
try {
createGitHubRepository(REPO_NAME, REPO_DESCRIPTION, IS_PRIVATE);
} catch (IOException | InterruptedException e) {
System.err.println("Error creating GitHub repository: " + e.getMessage());
e.printStackTrace();
}
}
public static void createGitHubRepository(String repoName, String description, boolean isPrivate)
throws IOException, InterruptedException {
if (GITHUB_PAT.equals("YOUR_PERSONAL_ACCESS_TOKEN")) {
System.err.println("错误：请将 GITHUB_PAT 替换为您的实际个人访问令牌。");
return;
}
HttpClient client = HttpClient.newBuilder().build();
// 构建请求体
String requestBody = String.format(
"{\"name\": \"%s\", \"description\": \"%s\", \"private\": %b}",
repoName, description, isPrivate
);
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://api.github.com/user/repos"))
.header("Authorization", "token " + GITHUB_PAT)
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(requestBody, StandardCharsets.UTF_8))
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
int statusCode = response.statusCode();
String responseBody = response.body();
if (statusCode == 201) { // 201 Created 
是成功创建资源的HTTP状态码
System.out.println("GitHub 仓库 '" + repoName + "' 创建成功！");
System.out.println("响应体: " + responseBody);
} else {
System.err.println("创建 GitHub 仓库失败。状态码: " + statusCode);
System.err.println("响应体: " + responseBody);
// 可以在此处解析错误信息，例如 GitHub API 返回的错误消息
}
}
} 代码说明：
通过GitHub REST API编程创建仓库是一个强大且灵活的功能，它使开发者能够将GitHub仓库管理无缝集成到自动化工作流中。本教程详细介绍了从生成个人访问令牌到构造API请求，再到提供Java代码示例的完整过程。掌握这一技能，将极大地提升您在自动化开发和部署方面的能力。请务必遵循安全最佳实践，以保护您的个人访问令牌和GitHub账户安全。
