Blog API

Pysio Home 博客的所有API

API密钥仅对博客管理者提供，尽情谅解

主页

get

https://blogapi.pysio.onlinehttp://localhost:5000

/

返回API服务的主页信息

Responses

200

成功返回主页信息

text/plain

ResponsestringExample: 你来这里干啥 喵?

get

/

HTTPcURLJavaScriptPython

GET / HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功返回主页信息

你来这里干啥 喵?

获取系统信息

get

https://blogapi.pysio.onlinehttp://localhost:5000

/fastfetch

使用fastfetch获取服务器系统信息，包含ANSI颜色代码

Responses

200

成功返回系统信息

application/json

500

服务器错误

application/json

get

/fastfetch

HTTPcURLJavaScriptPython

GET /fastfetch HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

{
  "status": "success",
  "output": "text"
}

心跳检测

post

https://blogapi.pysio.onlinehttp://localhost:5000

/heartbeat

发送应用心跳信息，用于监控应用状态。需要Bearer Token认证。

Authorizations

appAuth

AuthorizationstringRequired

使用应用Bearer令牌进行身份验证。在请求头中添加 'Authorization: Bearer {TOKEN}'

Body

application/x-www-form-urlencoded

applicationstringRequired

应用名称

introducestringOptional

应用描述

rgbastringOptional

RGBA 颜色值，格式如：233,30,99,0.17

applicationOnlinebooleanOptional

应用是否在线

Responses

200

心跳信息接收成功

application/json

401

认证失败

application/json

500

服务器错误

application/json

post

/heartbeat

HTTPcURLJavaScriptPython

POST /heartbeat HTTP/1.1
Host: blogapi.pysio.online
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/x-www-form-urlencoded
Accept: */*
Content-Length: 80

"application='text'&introduce='text'&rgba='text'&applicationOnline=true"

{
  "message": "Heartbeat received",
  "application": "text",
  "introduce": "text",
  "rgba": "text",
  "applicationOnline": true
}

检查服务状态

get

https://blogapi.pysio.onlinehttp://localhost:5000

/check

获取最近一次心跳信息和应用状态

Responses

200

成功返回服务状态

application/json

get

/check

HTTPcURLJavaScriptPython

GET /check HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功返回服务状态

{
  "alive": true,
  "last_heartbeat": null,
  "application": "text",
  "introduce": "text",
  "rgba": "text",
  "applicationOnline": true
}

获取服务状态SVG图标

get

https://blogapi.pysio.onlinehttp://localhost:5000

/check/svg

返回一个显示服务状态的SVG图标

Responses

200

成功返回SVG图标

image/svg+xml

Responsestring

get

/check/svg

HTTPcURLJavaScriptPython

GET /check/svg HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功返回SVG图标

text

随机获取图片

get

https://blogapi.pysio.onlinehttp://localhost:5000

/random_image

从图片库中随机返回一张图片，将重定向到Minio存储的图片URL

Responses

307

临时重定向到图片URL

404

没有可用的图片

application/json

get

/random_image

HTTPcURLJavaScriptPython

GET /random_image HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

No content

获取图片总数

get

https://blogapi.pysio.onlinehttp://localhost:5000

/images/count

返回图片库中的图片总数

Responses

200

成功返回图片总数

application/json

get

/images/count

HTTPcURLJavaScriptPython

GET /images/count HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功返回图片总数

{
  "count": 1
}

获取图片列表

get

https://blogapi.pysio.onlinehttp://localhost:5000

/images/list

返回图片库中所有图片的列表，支持分页

Query parameters

pageintegerOptional

页码，默认为1

Default: 1

limitintegerOptional

每页数量，默认为10

Default: 10

Responses

200

成功返回图片列表

application/json

get

/images/list

HTTPcURLJavaScriptPython

GET /images/list HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功返回图片列表

{
  "images": [
    {
      "hash": "text",
      "contentType": "text",
      "createdAt": "2026-01-01T01:33:55.011Z"
    }
  ],
  "pagination": {
    "current": 1,
    "size": 1,
    "total": 1
  }
}

添加新图片

post

https://blogapi.pysio.onlinehttp://localhost:5000

/images/add

上传新图片到图片库

Authorizations

adminAuth

AuthorizationstringRequired

使用管理员Bearer令牌进行身份验证。在请求头中添加 'Authorization: Bearer {ADMIN_TOKEN}'

Body

multipart/form-data

imagestring · binaryRequired

要上传的图片文件

Responses

201

图片上传成功

application/json

400

请求参数错误

application/json

401

未授权

409

图片已存在

application/json

post

/images/add

HTTPcURLJavaScriptPython

POST /images/add HTTP/1.1
Host: blogapi.pysio.online
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: multipart/form-data
Accept: */*
Content-Length: 18

{
  "image": "binary"
}

{
  "hash": "text",
  "size": 1
}

获取指定图片

get

https://blogapi.pysio.onlinehttp://localhost:5000

/images/{hash}

通过哈希值获取特定图片，将重定向到Minio存储的图片URL

Path parameters

hashstringRequired

图片哈希值

Responses

302

重定向到图片URL

404

图片不存在

get

/images/{hash}

HTTPcURLJavaScriptPython

GET /images/{hash} HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

No content

删除图片

delete

https://blogapi.pysio.onlinehttp://localhost:5000

/images/{hash}

通过哈希值删除特定图片

Authorizations

adminAuth

AuthorizationstringRequired

使用管理员Bearer令牌进行身份验证。在请求头中添加 'Authorization: Bearer {ADMIN_TOKEN}'

Path parameters

hashstringRequired

图片哈希值

Responses

200

图片删除成功

application/json

401

未授权

404

图片不存在

delete

/images/{hash}

HTTPcURLJavaScriptPython

DELETE /images/{hash} HTTP/1.1
Host: blogapi.pysio.online
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "Image deleted successfully"
}

通过 hash 直接访问图片

get

https://blogapi.pysio.onlinehttp://localhost:5000

/i/{hash}

简短URL方式访问图片，将重定向到Minio存储的图片URL

Path parameters

hashstringRequired

图片哈希值

Responses

302

重定向到图片URL

404

图片不存在

get

/i/{hash}

HTTPcURLJavaScriptPython

GET /i/{hash} HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

No content

获取 Steam 状态

get

https://blogapi.pysio.onlinehttp://localhost:5000

/steam_status

获取配置的Steam账号的游戏状态，如果正在游戏则返回详细游戏信息

Responses

200

成功返回 Steam 状态

application/json

Responseone of

or

500

服务器错误

application/json

get

/steam_status

HTTPcURLJavaScriptPython

GET /steam_status HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

{
  "status": "在游戏中",
  "game": "text",
  "game_id": "text",
  "description": "text",
  "price": "text",
  "playtime": "text",
  "achievement_percentage": "text"
}

IP 信息查询

get

https://blogapi.pysio.onlinehttp://localhost:5000

/ipcheck

获取指定IP地址的详细信息

Query parameters

ipstringRequired

要查询的IP地址

Responses

200

成功返回 IP 信息

application/json

400

请求参数错误

application/json

get

/ipcheck

HTTPcURLJavaScriptPython

GET /ipcheck?ip=text HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

{
  "ip": "text",
  "city": "text",
  "region": "text",
  "country": "text",
  "loc": "text",
  "org": "text",
  "postal": "text",
  "timezone": "text"
}

获取 API 调用统计

get

https://blogapi.pysio.onlinehttp://localhost:5000

/api_stats

获取所有API端点的调用次数统计

Responses

200

成功返回 API 调用统计

application/json

get

/api_stats

HTTPcURLJavaScriptPython

GET /api_stats HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功返回 API 调用统计

[
  {
    "key": "text",
    "count": 1,
    "lastUpdated": "2026-01-01T01:33:55.011Z"
  }
]

获取特定接口调用次数

get

https://blogapi.pysio.onlinehttp://localhost:5000

/api_stats/{key}

获取指定API端点的调用次数

Path parameters

keystringRequired

API路径

Responses

200

成功返回特定接口调用次数

application/json

404

未找到该API路径的统计信息

get

/api_stats/{key}

HTTPcURLJavaScriptPython

GET /api_stats/{key} HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

{
  "key": "text",
  "count": 1,
  "lastUpdated": "2026-01-01T01:33:55.011Z"
}

获取Cloudflare统计信息

get

https://blogapi.pysio.onlinehttp://localhost:5000

/cloudflare_stats

获取Cloudflare的域名访问统计信息

Responses

200

成功返回Cloudflare统计信息

application/json

Responseobject

get

/cloudflare_stats

HTTPcURLJavaScriptPython

GET /cloudflare_stats HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功返回Cloudflare统计信息

{}

404页面

get

https://blogapi.pysio.onlinehttp://localhost:5000

/404

返回404错误页面

Responses

404

页面未找到

get

/404

HTTPcURLJavaScriptPython

GET /404 HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

404

页面未找到

No content

服务器错误页面

get

https://blogapi.pysio.onlinehttp://localhost:5000

/50x

返回服务器错误页面

Responses

500

服务器内部错误

get

/50x

HTTPcURLJavaScriptPython

GET /50x HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

500

服务器内部错误

No content

刷新缓存

post

https://blogapi.pysio.onlinehttp://localhost:5000

/admin/refcache

刷新服务器缓存

Authorizations

adminAuth

AuthorizationstringRequired

使用管理员Bearer令牌进行身份验证。在请求头中添加 'Authorization: Bearer {ADMIN_TOKEN}'

Responses

200

缓存刷新成功

application/json

401

未授权

post

/admin/refcache

HTTPcURLJavaScriptPython

POST /admin/refcache HTTP/1.1
Host: blogapi.pysio.online
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "Cache refreshed successfully"
}

GitHub仓库代理

get

https://blogapi.pysio.onlinehttp://localhost:5000

/github/{path}

通过API服务器代理访问GitHub仓库

Path parameters

pathstringRequired

GitHub仓库路径

Responses

200

成功代理GitHub请求

No content

get

/github/{path}

HTTPcURLJavaScriptPython

GET /github/{path} HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功代理GitHub请求

No content

GitLab仓库代理

get

https://blogapi.pysio.onlinehttp://localhost:5000

/gitlab/{path}

通过API服务器代理访问GitLab仓库

Path parameters

pathstringRequired

GitLab仓库路径

Responses

200

成功代理GitLab请求

No content

get

/gitlab/{path}

HTTPcURLJavaScriptPython

GET /gitlab/{path} HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

200

成功代理GitLab请求

No content

GitHub API代理

get

https://blogapi.pysio.onlinehttp://localhost:5000

/githubapi/{path}

通过API服务器代理访问GitHub API

Path parameters

pathstringRequired

GitHub API路径

Responses

200

成功代理GitHub API请求

No content

403

API端点不在白名单中

get

/githubapi/{path}

HTTPcURLJavaScriptPython

GET /githubapi/{path} HTTP/1.1
Host: blogapi.pysio.online
Accept: */*

No content