如何使用GitHub REST API实现类似Azure DevOps的文件下载功能？

1. 直接下载的行为设计本质不同 #

• Azure DevOps的download=true是API原生支持的下载触发参数：当你在浏览器访问该URL时，ADO API会直接返回文件的原始二进制内容，同时设置Content-Disposition响应头指定文件名，浏览器识别后自动启动下载流程。而且浏览器访问时会自动带上你已登录的会话凭证，私有仓库也能直接完成下载。
• GitHub的/contents端点不支持download=true参数，你添加的这个参数对GitHub API完全无效。该端点的默认设计就是返回包含Base64编码文件内容的JSON对象，这是GitHub REST API获取文件内容的标准返回格式，和你加不加无效参数无关。

2. 私有仓库的访问授权机制差异 #

• ADO在浏览器环境下依赖会话Cookie授权：只要你在浏览器登录了ADO且拥有仓库权限，请求会自动携带会话凭证，因此能直接访问并下载文件。
• GitHub的api.github.com API端点不支持直接使用浏览器会话Cookie授权，所以私有仓库直接在浏览器访问该URL会返回未授权错误。即便用curl携带PAT请求，/contents端点依然返回JSON结构，不会返回原始文件内容。

3. 复刻ADO下载行为的正确方式 #

如果要实现和ADO一样的直接下载效果，需要使用GitHub的原始文件端点，而非/contents API：

https://raw.githubusercontent.com/<Org>/<Repository>/develop/<Path to file>/DEV1.yml

这个端点会直接返回文件的原始二进制内容，浏览器访问时（已登录且有权限）会自动触发下载；用curl访问私有仓库的话，需要在请求头中携带PAT：

curl -H "Authorization: token <你的PAT>" https://raw.githubusercontent.com/<Org>/<Repository>/develop/<Path to file>/DEV1.yml > DEV1.yml

内容的提问来源于stack exchange，提问作者agw2021