隐藏侧边栏

『转载』使用GitHub API上传文件及GitHub做图床

 邱少羽梦
2022-07-03 / 0 评论 / 0 点赞 / 56 阅读 / 2,623 字 / 正在检测是否收录...
温馨提示:
本文最后更新于 2022-07-03,若内容或图片失效,请留言反馈。部分素材来自网络,若不小心影响到您的利益,请联系博主删除。

img

本文介绍GitHub API基础及上传文件到仓库API,并应用API将GitHub作为图床

GitHub API官方页面

GitHub API版本

当前版本为v3,官方推荐在请求头中显示添加版本标识。

Accept: application/vnd.github.v3+json

Postman示例如图:

img

请求认证

  • 基础认证|Basic authentication

shell示例:

curl -u "username" https://api.github.com

Postman示例如图:

img

  • 令牌认证|OAuth2 token (sent in a header)

shell示例:

curl -H "Authorization: token OAUTH-TOKEN" https://api.github.com

Postman示例如图:

img

主API,获取所有API

请求API:
GET https://api.github.com

这个API返回常见API

Postman示例如图:

img

公开仓库查询API

请求API:
GET https://api.github.com/user/repos
header:
namevalue
Acceptapplication/vnd.github.v3+json
Authorizationtoken空格oauth_token

Postman示例如图:

img

仓库创建API

请求API:
POST https://api.github.com/user/repos
headers:
  • Accept : application/vnd.github.v3+json
  • Authorization : token空格oauth_token|
请求体|Request body:

name,代表仓库名,必须。其他的可选参数参看官方文档

{
    "name":"imgs"
}

Postman示例如图:

img

为仓库上传/更新文件API

请求API:
PUT https://api.github.com/repos/{user}/imgs/contents/{path}/{filename}
  • user:仓库所属用户名
  • path:上传文件存放的路径,如果文件夹不存在,会自动创建
  • filename:上传的文件名称
请求体|Request body:
{
  "message": "提交说明",
  "content": "base64编码的文件内容",
  "sha": "文件的blob sha"
}

content:文件内容的base64编码后的字符串

sha:文件更新或删除时必填,先用GET接口查询文件信息,可在响应体中获取

Postman示例如图:

img

从仓库删除文件API

请求API:
DELETE https://api.github.com/repos/{user}/imgs/contents/{path}/{filename}
  • user:仓库所属用户名
  • path:上传文件存放的路径,如果文件夹不存在,会自动创建
  • filename:上传的文件名称
请求体|Request body:
{
  "message": "提交说明",
  "sha": "文件的blob sha"
}

sha:文件更新或删除时必填,先用GET接口查询文件信息,可在响应体中获取

token的生成

token需要在GitHub网站上右上角Settings中去生成,生成后需要立即保存。

  • 点击Settings

img

  • 点击Developer settings

img

  • 点击Personal access tokens

img

  • 点击Generate new token,生成token并记录

img

仓库作为图床

仓库要想作为图床,图床的前提是文件内容能外链使用,需要将其作为GitHub Pages才能实现。

将仓库作为图床的整体操作步骤如下:

  • 1 创建一个仓库,将添加一个index.html

由于我们要将此仓库作为图床,所以虽不需要静态网站相关内容,但为了GitHub能将此仓库识别为GitHub Pages,还是至少需要一个index.html在仓库中。(当然,你也可以找寻一个静态网站模板放进仓库)

index.html示例:

<!DOCTYPE html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width-device-width,initial-scale-1">
    <title>Images</title>
  </head>
  <body></body>
</html>

示例如图:

img

  • 2 将此仓库配置为GitHub Pages

相关配置可以参看多项目部署为同一个GitHub Pages

img

开启GitHub Pages成功后,当前仓库文件就可通过GitHub Pages地址访问,图中示例为https://dev2007.github.io/imgs

  • 3 将图片上传到仓库中

{仓库}/{路径}/{文件名}

示例如图:

img

  • 4 获取图片链接,使用链接

链接格式为:https://{Pages域名}/{仓库}/{路径}/{文件名}

示例地址:https://dev2007.github.io/imgs/myfolder/panda.png

示例如图:

img

  • 5 使用自定义域名,配置好后Pages域名换为自定义域名即可

相关GitHub Pages配置域名,可参看用GitHub Pages搭建博客(五)

  • 6 CDN加速

可以使用Vercel进行加速,可参看用GitHub Pages搭建博客(六)

Demo图床

最后是我搭建的一个Demo图床,可以访问,后续还将添加网页图片上传功能,欢迎查看:图床

欢迎关注我的博客:阿呜的边城

欢迎关注我的公众号:阿呜的编程

img

博主转载声明

博主转载对自己有用的文章,以便不时之需,不进行商业用途,希望博主的转载也能帮助到您,如果对您有帮助,也请您支持下原作者哦。
文章内容全部转载,原文地址:
https://www.shuzhiduo.com/A/Vx5MDry7JN/
0

评论区