Skip to content
heiemooaPublic

About

🔥🔥🔥 一些实用的 API Tools, 如随机图片、高斯模糊缩略图、每日必应等 | Some practical API Tools, such as random pictures, Gaussian blur thumbnails, daily Bing, etc.

Resources

Stars

5 stars

Watchers

1 watching

Forks

Repository files navigation

logo

API Tools

基于 Typescript、Koa 实现的一些实用的 API 工具, 如随机图片、每日必应、本地IP等 | Some practical API Tools, such as random pictures, daily Bing, local IP, etc.

总览

🟢 状态正常 🟠 可能失效 ❌ 无法使用

功能 调用名称 状态
图片 API img 🟢
随机图片 aimg 🟢
每日必应 bing 🟢
站点状态 status 🟢
定时任务 无 <默认关闭> 🟢

启动

// 安装依赖
yarn

// 构建
yarn build

// 本地启动
yarn dev

// 远程部署
yarn start

使用

1、图片 API

  • 支持参数
参数 属性 默认值 定义
url string 必填 无 图片路径
theme boolean 非必填 false 是否返回图片主题色
greyscale boolean 非必填 false 是否返回灰度图片
base64 boolean 非必填 false 是否返回 base64 图片
quality number 非必填 100 图片质量(0-100)
gaussian number 非必填 0 高斯模糊(0-20)
width number 非必填 无 宽度(大于 0)
height number 非必填 无 高度(大于 0)
  • 主题色

    GET https://example.com/img?url=$url&theme=true
  • 灰度图片

    GET https://example.com/img?url=$url&greyscale=true
  • base64

    GET https://example.com/img?url=$url&base64=true
  • 图片压缩

    GET https://example.com/img?url=$url&quality=70
  • 高斯模糊

    GET https://example.com/img?url=$url&gaussian=10
  • 缩略图

    GET https://example.com/img?url=$url&width=$width&height=$height

2、随机图片

  • 支持参数
参数 属性 默认值 定义
idx number 非必填 0 跳转到指定 idx 的图片,从 0 开始。0 表示当天的图片,1 表示昨天的图片,依此类推。最大值不限
type boolean 非必填 无 图片类型,json(返回 json 数据)或 raw(服务端渲染返回)
  • 随机跳转一张图片

    GET https://example.com/aimg
  • 跳转到指定 idx 的图片,从 0 开始。0 表示当天的图片,1 表示昨天的图片,依此类推。最大值不限

    GET https://example.com/aimg?idx=1
  • 获取包含随机 indx 的图片信息,以 json 格式返回

    GET https://example.com/aimg?type=json
  • 获取包含指定 idx 的图片信息,以 json 格式返回

    GET https://example.com/aimg?idx=1&type=json
  • 服务端随机加载一张图片并输出

    GET https://example.com/aimg?type=raw
  • 服务端加载指定 ID 的图片并输出

    GET https://example.com/aimg?idx=1&type=raw

3、每日必应

  • 支持参数
参数 默认 必填 说明
uhdwidth 无 否 图宽度片
uhdheight 无 否 图片高度
uhd 无 否 高清与否
n 1 否 获取的图片数量,最大为 8
idx 0 否 获取的图片在历史记录中的索引,最大为 7
  • 详细信息

    GET https://example.com/bing

4、站点状态

反代 UptimeRobot 以实现站点监控

POST https://example.com/status

5、定时任务

目前添加了一个定时任务,支持在每天 0 点同步今日必应图片到远程 Github 文件夹

远程仓库:https://github.com/heiemooa/folder

持续添加中

Vercel 部署

现已支持 Vercel 部署,无需服务器

操作方法

  1. fork 本项目
  2. 在 Vercel 官网点击 New Project
  3. 点击 Import Git Repository 并选择你 fork 的此项目并点击 import
  4. PROJECT NAME自己填,FRAMEWORK PRESET 选 Other 然后直接点 Deploy 接着等部署完成即可

Docker 部署自有服务器

我用的 Github Action 自动化构建 Docker 镜像

操作方法

  1. fork 本项目
  2. 创建 tag,我 wirkflows/docker.yml 监听的是 release push,所以手动创建 Release,也可以自行改成监听 tag push
  3. 登录服务器
  4. 配置 docker compose (自行配置),重启 api-tools
docker stop <Image Name | api-tools>
docker image rm -f <Image Name | emooa/api-tools>
docker compose up -d

其他

  • 本项目为了避免频繁请求官方数据,默认对数据做了缓存处理,默认为 30 分钟,如需更改,请自行前往 utils\cache.js 文件修改
  • 本项目部分接口使用了 页面爬虫,若违反对应页面的相关规则,请 及时通知我去除该接口

免责声明

  • 本项目提供的 API 仅供开发者进行技术研究和开发测试使用。使用该 API 获取的信息仅供参考,不代表本项目对信息的准确性、可靠性、合法性、完整性作出任何承诺或保证。本项目不对任何因使用该 API 获取信息而导致的任何直接或间接损失负责。本项目保留随时更改 API 接口地址、接口协议、接口参数及其他相关内容的权利。本项目对使用者使用 API 的行为不承担任何直接或间接的法律责任
  • 本项目并未与相关信息提供方建立任何关联或合作关系,获取的信息均来自公开渠道,如因使用该 API 获取信息而产生的任何法律责任,由使用者自行承担
  • 本项目对使用 API 获取的信息进行了最大限度的筛选和整理,但不保证信息的准确性和完整性。使用 API 获取信息时,请务必自行核实信息的真实性和可靠性,谨慎处理相关事项
  • 本项目保留对 API 的随时更改、停用、限制使用等措施的权利。任何因使用本 API 产生的损失,本项目不负担任何赔偿和责任

鸣谢

  • ToolsApi 基于此项目进行修改,并 Typescript 语言化

About

🔥🔥🔥 一些实用的 API Tools, 如随机图片、高斯模糊缩略图、每日必应等 | Some practical API Tools, such as random pictures, Gaussian blur thumbnails, daily Bing, etc.

Resources

Stars

5 stars

Watchers

1 watching

Forks

Releases

Packages

Used by

Contributors

Languages