Blog API

Pysio Home 博客的所有API

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

主页

get

返回API服务的主页信息

Responses

200

成功返回主页信息

text/plain

stringOptionalExample: 你来这里干啥喵?

get

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

200

成功返回主页信息

你来这里干啥 喵?

获取系统信息

get

/fastfetch

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

Responses

200

成功返回系统信息

application/json

statusstringOptionalExample: success

outputstringOptional

带ANSI颜色代码的系统信息输出

500

服务器错误

application/json

get

/fastfetch

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

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

心跳检测

post

/heartbeat

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

Authorizations

AuthorizationstringRequired

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

Body

applicationstringRequired

应用名称

introducestringOptional

应用描述

rgbastringOptional

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

applicationOnlinebooleanOptional

应用是否在线

Responses

200

心跳信息接收成功

application/json

messagestringOptionalExample: Heartbeat received

applicationstringOptional

introducestringOptional

rgbastringOptional

applicationOnlinebooleanOptional

401

认证失败

application/json

500

服务器错误

application/json

post

/heartbeat

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

/check

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

Responses

200

成功返回服务状态

application/json

alivebooleanOptional

服务是否存活

last_heartbeatnumber · nullableOptional

最后一次心跳时间戳

applicationstringOptional

应用名称

introducestringOptional

应用描述

rgbastringOptional

RGBA 颜色值

applicationOnlinebooleanOptional

应用是否在线

get

/check

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

/check/svg

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

Responses

200

成功返回SVG图标

image/svg+xml

stringOptional

get

/check/svg

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

200

成功返回SVG图标

text

随机获取图片

get

/random_image

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

Responses

307

临时重定向到图片URL

404

没有可用的图片

application/json

get

/random_image

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

No content

获取图片总数

get

/images/count

返回图片库中的图片总数

Responses

200

成功返回图片总数

application/json

countintegerOptional

图片总数

get

/images/count

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

200

成功返回图片总数

{
  "count": 1
}

获取图片列表

get

/images/list

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

Query parameters

pageintegerOptional

页码，默认为1

Default: 1

limitintegerOptional

每页数量，默认为10

Default: 10

Responses

200

成功返回图片列表

application/json

get

/images/list

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

200

成功返回图片列表

{
  "images": [
    {
      "hash": "text",
      "contentType": "text",
      "createdAt": "2026-04-02T12:07:19.856Z"
    }
  ],
  "pagination": {
    "current": 1,
    "size": 1,
    "total": 1
  }
}

添加新图片

post

/images/add

上传新图片到图片库

Authorizations

AuthorizationstringRequired

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

Body

imagestring · binaryRequired

要上传的图片文件

Responses

201

图片上传成功

application/json

400

请求参数错误

application/json

401

未授权

409

图片已存在

application/json

post

/images/add

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

/images/{hash}

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

Path parameters

hashstringRequired

图片哈希值

Responses

302

重定向到图片URL

404

图片不存在

get

/images/{hash}

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

No content

删除图片

delete

/images/{hash}

通过哈希值删除特定图片

Authorizations

AuthorizationstringRequired

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

Path parameters

hashstringRequired

图片哈希值

Responses

200

图片删除成功

application/json

messagestringOptionalExample: Image deleted successfully

401

未授权

404

图片不存在

delete

/images/{hash}

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

{
  "message": "Image deleted successfully"
}

通过 hash 直接访问图片

get

/i/{hash}

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

Path parameters

hashstringRequired

图片哈希值

Responses

302

重定向到图片URL

404

图片不存在

get

/i/{hash}

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

No content

获取 Steam 状态

get

/steam_status

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

Responses

200

成功返回 Steam 状态

application/json

500

服务器错误

application/json

get

/steam_status

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

/ipcheck

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

Query parameters

ipstringRequired

要查询的IP地址

Responses

200

成功返回 IP 信息

application/json

ipstringOptional

IP地址

citystringOptional

城市

regionstringOptional

地区

countrystringOptional

国家

locstringOptional

经纬度

orgstringOptional

组织

postalstringOptional

邮政编码

timezonestringOptional

时区

400

请求参数错误

application/json

get

/ipcheck

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

/api_stats

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

Responses

200

成功返回 API 调用统计

application/json

keystringOptional

API路径

countintegerOptional

调用次数

lastUpdatedstring · date-timeOptional

最后更新时间

get

/api_stats

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

200

成功返回 API 调用统计

[
  {
    "key": "text",
    "count": 1,
    "lastUpdated": "2026-04-02T12:07:19.856Z"
  }
]

获取特定接口调用次数

get

/api_stats/{key}

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

Path parameters

keystringRequired

API路径

Responses

200

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

application/json

keystringOptional

API路径

countintegerOptional

调用次数

lastUpdatedstring · date-timeOptional

最后更新时间

404

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

get

/api_stats/{key}

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

{
  "key": "text",
  "count": 1,
  "lastUpdated": "2026-04-02T12:07:19.856Z"
}

获取Cloudflare统计信息

get

/cloudflare_stats

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

Responses

200

成功返回Cloudflare统计信息

application/json

objectOptional

get

/cloudflare_stats

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

200

成功返回Cloudflare统计信息

{}

404页面

get

/404

返回404错误页面

Responses

404

页面未找到

get

/404

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

404

页面未找到

No content

服务器错误页面

get

/50x

返回服务器错误页面

Responses

500

服务器内部错误

get

/50x

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

500

服务器内部错误

No content

刷新缓存

post

/admin/refcache

刷新服务器缓存

Authorizations

AuthorizationstringRequired

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

Responses

200

缓存刷新成功

application/json

messagestringOptionalExample: Cache refreshed successfully

401

未授权

post

/admin/refcache

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

{
  "message": "Cache refreshed successfully"
}

GitHub仓库代理

get

/github/{path}

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

Path parameters

pathstringRequired

GitHub仓库路径

Responses

200

成功代理GitHub请求

No content

get

/github/{path}

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

200

成功代理GitHub请求

No content

GitLab仓库代理

get

/gitlab/{path}

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

Path parameters

pathstringRequired

GitLab仓库路径

Responses

200

成功代理GitLab请求

No content

get

/gitlab/{path}

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

200

成功代理GitLab请求

No content

GitHub API代理

get

/githubapi/{path}

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

Path parameters

pathstringRequired

GitHub API路径

Responses

200

成功代理GitHub API请求

No content

403

API端点不在白名单中

get

/githubapi/{path}

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

No content

Last updated 1 year ago

Was this helpful?

hashtag主页

hashtag获取系统信息

hashtag心跳检测

hashtag检查服务状态

hashtag获取服务状态SVG图标

hashtag随机获取图片

hashtag获取图片总数

hashtag获取图片列表

hashtag添加新图片

hashtag获取指定图片

hashtag删除图片

hashtag通过 hash 直接访问图片

hashtag获取 Steam 状态

hashtagIP 信息查询

hashtag获取 API 调用统计

hashtag获取特定接口调用次数

hashtag获取Cloudflare统计信息

hashtag404页面

hashtag服务器错误页面

hashtag刷新缓存

hashtagGitHub仓库代理

hashtagGitLab仓库代理

hashtagGitHub API代理

主页

获取系统信息

心跳检测

检查服务状态

获取服务状态SVG图标

随机获取图片

获取图片总数

获取图片列表

添加新图片

获取指定图片

删除图片

通过 hash 直接访问图片

获取 Steam 状态

IP 信息查询

获取 API 调用统计

获取特定接口调用次数

获取Cloudflare统计信息

404页面

服务器错误页面

刷新缓存

GitHub仓库代理

GitLab仓库代理

GitHub API代理