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

GitHub API官方页面 (opens new window)

# GitHub API版本

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

Accept: application/vnd.github.v3+json

Postman示例如图:

api版本

# 请求认证

  • 基础认证|Basic authentication

shell示例:

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

Postman示例如图:

api认证

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

shell示例:

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

Postman示例如图:

api token

# 主API,获取所有API

请求API:

GET https://api.github.com

这个API返回常见API

Postman示例如图:

basic api response

# 公开仓库查询API

请求API:

GET https://api.github.com/user/repos

header:

name value
Accept application/vnd.github.v3+json
Authorization token空格oauth_token

Postman示例如图:

list repo

# 仓库创建API

请求API:

POST https://api.github.com/user/repos

headers:

  • Accept : application/vnd.github.v3+json

  • Authorization : token空格oauth_token|

请求体|Request body:

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

{
    "name":"imgs"
}

Postman示例如图:

create repo

# 为仓库上传/更新文件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示例如图:

upload file

# 从仓库删除文件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

setting

  • 点击Developer settings

setting2

  • 点击Personal access tokens

setting3

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

setting4

# 仓库作为图床

仓库要想作为图床,图床的前提是文件内容能外链使用,需要将其作为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>

示例如图:

repo index

  • 2 将此仓库配置为GitHub Pages

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

pages

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

  • 3 将图片上传到仓库中

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

示例如图:

repo img

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

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

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

示例图床图片 (opens new window)

示例如图:

pages img

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

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

  • 6 CDN加速

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

题图来源 :unsplash (opens new window)