codeload.github.com 与 api.github.com 有何不同？

Question

我在浏览 next.js 存储库时注意到了这个从 GitHub 下载并提取模板的功能，带有 tar：

export async function downloadAndExtractExample(
  root: string,
  name: string
): Promise<void> {
  return await promisePipe(
    got.stream('https://codeload.github.com/zeit/next.js/tar.gz/canary'),
    tar.extract({ cwd: root, strip: 3 }, [`next.js-canary/examples/${name}`])
  )
}

我在 StackOverflow 上搜索，我只找到了这个：

• GitHub Api download zip or tarball link

这是一个解释如何从 GitHub 提取 tar.gz 的线程，但没有提及“codeload”子域。和“api”有什么区别？

Answer 1

GitHub API 提供了获取下载档案的 URL 的最佳方式。当您对该 URL 发出 GET 请求时，它会将您重定向到 codeload.github.com 上的 URL。 codeload 是提供档案供下载的服务，出于缓存原因，它位于自己的域中。

虽然可以直接使用代码加载 URL，但您通常希望使用 API URL，因为它可以更优雅地处理身份验证等事情，而且私有存储库的代码加载 URL 通常是短暂的。