如何从 GitHub API 获取最后一次提交

Question

这是使用 GitHub API（Rest API v3）从 git 存储库获取最新提交信息的最佳方式。

选项 1：GET /repos/:owner/:repo/commits/master
我可以假设响应的对象“提交”是分支 master 的最新提交吗？

选项 2：GET /repos/:owner/:repo/git/commits/5a2ff
或者进行两次调用，一次通过从 master 获取 HEAD ref 来获取 sha，然后使用返回的 sha 获取提交信息。

Answer 1

这取决于你对“最后”的定义。

• 对于给定的分支（如master），GET /repos/:owner/:repo/commits/master 确实是最后一次（最近的）提交。

• 但您也可以考虑the last push event：它代表最后和最近完成的提交（在任何分支上），由用户推送到此存储库。

Answer 2

您也可以使用Github GraphQL v4 获取默认分支的最后一次提交：

{
  repository(name: "linux", owner: "torvalds") {
    defaultBranchRef {
      target {
        ... on Commit {
          history(first: 1) {
            nodes {
              message
              committedDate
              authoredDate
              oid
              author {
                email
                name
              }
            }
          }
        }
      }
    }
  }
}

或者对于所有分支：

{
  repository(name: "material-ui", owner: "mui-org") {
    refs(first: 100, refPrefix: "refs/heads/") {
      edges {
        node {
          name
          target {
            ... on Commit {
              history(first: 1) {
                nodes {
                  message
                  committedDate
                  authoredDate
                  oid
                  author {
                    email
                    name
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

Try it in the explorer

Answer 3

从用户获取最新提交的另一种方法是使用以下端点。澄清一下，这只会显示public 事件，因此不会显示推送到私有存储库。 https://api.github.com/users/<username>/events/public

Answer 4

如果您只需要某个分支的最新提交的 SHA1，这里有一个 curl 请求可以做到：

curl -s -H "Authorization: token {your_github_access_token}" \
-H "Accept: application/vnd.github.VERSION.sha" \ 
"https://api.github.com/repos/{owner}/{repository_name}/commits/{branch_name}"