Edit

Blog API

Pysio Home 博客的所有API

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

主页

get

返回API服务的主页信息

Responses
200

成功返回主页信息

text/plain
ResponsestringExample: 你来这里干啥 喵?
get
GET / HTTP/1.1
Host: blogapi.pysio.online
Accept: */*
200

成功返回主页信息

你来这里干啥 喵?

获取系统信息

get

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

Responses
200

成功返回系统信息

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

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

心跳检测

post

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

Authorizations
Body
applicationstringRequired

应用名称

introducestringOptional

应用描述

rgbastringOptional

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

applicationOnlinebooleanOptional

应用是否在线

Responses
200

心跳信息接收成功

application/json
post
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

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

Responses
200

成功返回服务状态

application/json
get
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

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

Responses
200

成功返回SVG图标

image/svg+xml
Responsestring
get
GET /check/svg HTTP/1.1
Host: blogapi.pysio.online
Accept: */*
200

成功返回SVG图标

text

随机获取图片

get

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

Responses
307

临时重定向到图片URL

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

No content

获取图片总数

get

返回图片库中的图片总数

Responses
200

成功返回图片总数

application/json
get
GET /images/count HTTP/1.1
Host: blogapi.pysio.online
Accept: */*
200

成功返回图片总数

{
  "count": 1
}

获取图片列表

get

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

Query parameters
pageintegerOptional

页码，默认为1

Default: 1
limitintegerOptional

每页数量，默认为10

Default: 10
Responses
200

成功返回图片列表

application/json
get
GET /images/list HTTP/1.1
Host: blogapi.pysio.online
Accept: */*
200

成功返回图片列表

{
  "images": [
    {
      "hash": "text",
      "contentType": "text",
      "createdAt": "2025-09-25T19:57:55.697Z"
    }
  ],
  "pagination": {
    "current": 1,
    "size": 1,
    "total": 1
  }
}

添加新图片

post

上传新图片到图片库

Authorizations
Body
imagestring · binaryRequired

要上传的图片文件

Responses
201

图片上传成功

application/json
post
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

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

Path parameters
hashstringRequired

图片哈希值

Responses
302

重定向到图片URL

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

No content

删除图片

delete

通过哈希值删除特定图片

Authorizations
Path parameters
hashstringRequired

图片哈希值

Responses
200

图片删除成功

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

{
  "message": "Image deleted successfully"
}

通过 hash 直接访问图片

get

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

Path parameters
hashstringRequired

图片哈希值

Responses
302

重定向到图片URL

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

No content

获取 Steam 状态

get

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

Responses
200

成功返回 Steam 状态

application/json
Responseone of
or
get
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

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

Query parameters
ipstringRequired

要查询的IP地址

Responses
200

成功返回 IP 信息

application/json
get
GET /ipcheck 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端点的调用次数统计

Responses
200

成功返回 API 调用统计

application/json
get
GET /api_stats HTTP/1.1
Host: blogapi.pysio.online
Accept: */*
200

成功返回 API 调用统计

[
  {
    "key": "text",
    "count": 1,
    "lastUpdated": "2025-09-25T19:57:55.697Z"
  }
]

获取特定接口调用次数

get

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

Path parameters
keystringRequired

API路径

Responses
200

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

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

{
  "key": "text",
  "count": 1,
  "lastUpdated": "2025-09-25T19:57:55.697Z"
}

获取Cloudflare统计信息

get

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

Responses
200

成功返回Cloudflare统计信息

application/json
Responseobject
get
GET /cloudflare_stats HTTP/1.1
Host: blogapi.pysio.online
Accept: */*
200

成功返回Cloudflare统计信息

{}

404页面

get

返回404错误页面

Responses
404

页面未找到

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

页面未找到

No content

服务器错误页面

get

返回服务器错误页面

Responses
500

服务器内部错误

No content
get
GET /50x HTTP/1.1
Host: blogapi.pysio.online
Accept: */*
500

服务器内部错误

No content

刷新缓存

post

刷新服务器缓存

Authorizations
Responses
200

缓存刷新成功

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

{
  "message": "Cache refreshed successfully"
}

GitHub仓库代理

get

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

Path parameters
pathstringRequired

GitHub仓库路径

Responses
200

成功代理GitHub请求

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

成功代理GitHub请求

No content

GitLab仓库代理

get

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

Path parameters
pathstringRequired

GitLab仓库路径

Responses
200

成功代理GitLab请求

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

成功代理GitLab请求

No content

GitHub API代理

get

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

Path parameters
pathstringRequired

GitHub API路径

Responses
200

成功代理GitHub API请求

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

No content

Last updated

Was this helpful?