通过REST API管理Github仓库

要通过接口管理 GitHub 的仓库，可以使用 GitHub 提供的 REST API 或 GraphQL API。以下是使用 GitHub REST API 管理仓库的一些基本步骤：

1. 获取访问令牌

首先，你需要生成一个 GitHub 个人访问令牌（Personal Access Token，PAT）。这个令牌用于认证你的 API 请求。

步骤：

登录 GitHub。
进入 Settings > Developer settings > Personal access tokens。
生成新令牌，并选择需要的权限（如 repo 权限来管理仓库）。

2. 使用 REST API 管理仓库

GitHub REST API 提供了多种用于管理仓库的操作，比如创建、更新、删除仓库，以及管理仓库的文件、分支、权限等。

创建一个新仓库

你可以通过以下 POST 请求来创建一个新的仓库：

curl -H "Authorization: token YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -X POST \
     -d '{"name": "my-new-repo", "private": false}' \
     https://api.github.com/user/repos

参数：

name: 仓库的名称。
private: 是否将仓库设置为私有。

获取用户的所有仓库

你可以通过以下 GET 请求获取用户的所有仓库：

1 2	curl -H "Authorization: token YOUR_ACCESS_TOKEN" \ https://api.github.com/user/repos

删除一个仓库

你可以通过以下 DELETE 请求删除一个仓库：

1
2
3

curl -H "Authorization: token YOUR_ACCESS_TOKEN" \
     -X DELETE \
     https://api.github.com/repos/USERNAME/REPO_NAME

注意：删除操作不可逆，请谨慎使用。

3. 使用 GraphQL API

GitHub 的 GraphQL API 更加灵活，允许你在一个请求中获取或修改多个资源。

查询仓库信息

你可以使用以下 GraphQL 查询获取指定仓库的信息：

query {
  repository(owner: "OWNER_NAME", name: "REPO_NAME") {
    name
    description
    isPrivate
  }
}

请求示例：

curl -H "Authorization: token YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -X POST \
     -d '{"query": "query { repository(owner: \"OWNER_NAME\", name: \"REPO_NAME\") { name description isPrivate } }"}' \
     https://api.github.com/graphql

4. 使用 Octokit.js 库

如果你更喜欢在 JavaScript/Node.js 环境中操作，可以使用 GitHub 官方提供的 Octokit.js 库，它封装了 GitHub API，使用更加方便。

示例：创建一个新仓库

const { Octokit } = require("@octokit/rest");
const octokit = new Octokit({ auth: `YOUR_ACCESS_TOKEN` });

async function createRepo() {
  const response = await octokit.rest.repos.createForAuthenticatedUser({
    name: 'my-new-repo',
    private: false
  });
  console.log(response.data);
}

createRepo();

5. 文档与资源

通过这些接口，你可以方便地在代码中管理 GitHub 仓库，实现自动化和集成操作。