接口文档

登录 / 注册

共 9 个接口在线。接入前请先看 接入指南: 注册账号 → 用户中心生成 API Key → 请求时携带密钥。每个接口右侧可「试一试」在线测试。

必应每日壁纸

GET 图片服务 免费

返回必应每日壁纸(最高 4K UHD),支持 json / 图片直跳

/api/?p=bing

功能概述

返回必应每日壁纸元数据,最高支持 4K UHD 分辨率。数据来自必应壁纸接口(已做 1 小时缓存),支持 JSON 与图片 302 直跳两种输出方式,可直接用作网站背景、每日签到配图。

请求参数

参数类型必填说明
idxint否偏移天数:0=今日,1=昨日,最大 7,默认 0
nint否返回条数,1~8,默认 1
mktstring否地区市场:zh-CN / en-US,默认 zh-CN
resstring否分辨率:uhd(4K)或 1080p,默认 uhd;壁纸无 UHD 版本时自动降级 1080P
outputstring否输出方式:json 或 image,默认 json;image 时 302 直接跳转图片地址(取第一张)

返回字段

字段类型说明
countint本次返回的壁纸数量
marketstring实际使用的地区市场
resolutionstring实际使用的分辨率(含降级后的结果)
imagesarray壁纸列表,元素字段见下表

images 元素字段:

字段类型说明
datestring壁纸日期,格式 YYYYMMDD
titlestring壁纸标题
copyrightstring版权说明(必须保留,禁止删除)
copyright_linkstring版权来源链接
urlstring按 res 选定的图片地址
url_uhdstring4K UHD 备用地址
url_1080pstring1080P 备用地址

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "count": 1,
    "market": "zh-CN",
    "resolution": "uhd",
    "images": [
      {
        "date": "20260906",
        "title": "菲安斯湖",
        "copyright": "菲安斯湖,澳大利亚 (© Bill Bachmann)",
        "copyright_link": "https://www.bing.com",
        "url": "https://cn.bing.com/th?id=OHR.FjaerlandNorway_ZH-CN0000000000_UHD.jpg",
        "url_uhd": "https://cn.bing.com/th?id=OHR.FjaerlandNorway_ZH-CN0000000000_UHD.jpg",
        "url_1080p": "https://cn.bing.com/th?id=OHR.FjaerlandNorway_ZH-CN0000000000_1920x1080.jpg"
      }
    ]
  }
}

常用调用示例

  • 今日壁纸 JSON:/api/?p=bing
  • 今日壁纸图片直链(可直接放 <img> 或背景):/api/?p=bing&output=image
  • 昨日国际版两张:/api/?p=bing&idx=1&mkt=en-US&n=2
  • 只要 1080P:/api/?p=bing&res=1080p

注意事项

  • 图片版权归必应及摄影师所有,禁止商用售卖,使用时请保留版权信息。
  • 数据来自非官方接口,元数据与分辨率探测结果缓存 1 小时;源站不可用时返回 502。

站点图标 Favicon

GET 图片服务 1 积分/次

获取任意网站的 favicon 图标并直接输出图片,多源回退 + 7 天缓存

/api/?p=favicon

功能概述

获取任意网站的 favicon 图标并直接输出图片(Content-Type 为对应图片类型),可直接写在 <img src> 里使用。自动按顺序尝试:站点 HTML 声明的图标 → /favicon.ico → /favicon.svg → HTTP 兜底 → Google s2 → DuckDuckGo,命中即返回;结果缓存 7 天(取不到的负缓存 6 小时)。

请求参数

参数类型必填说明
domainstring是纯域名,如 youku.com;不接受 URL、IP、内网主机名
sizeint否16~256,默认 64;GD 可用时对位图等比缩放(只缩不放)

返回格式

本接口不返回 JSON,直接输出图片二进制(image/png / image/x-icon / image/svg+xml 等)。取不到图标时返回 JSON 错误(404)。

常用调用示例

  • 网页里直接引用:<img src="/api/?p=favicon&domain=youku.com&size=64&key=你的密钥">
  • 浏览器直接打开:/api/?p=favicon&domain=github.com
  • 指定尺寸:/api/?p=favicon&domain=weibo.com&size=128

注意事项

  • 鉴权方式与其他接口一致(密钥必传),频率限流与计费规则同样适用。
  • 已内置 SSRF 防护(拒绝内网地址)与 SVG 净化(移除脚本/外部引用),可放心引用第三方站点。
  • 缓存存放在 data/favicon_cache/,覆盖上传时请勿删除 data/ 目录。
  • 无 GD 扩展的环境不缩放、原尺寸返回;SVG 无法服务端缩放,按原样式补齐尺寸属性。

服务器时间

GET 基础服务 免费

返回服务器当前时间、时间戳与星期几

/api/?p=time

功能概述

返回服务器当前时间、Unix 时间戳与星期几,服务器时区为北京时间(Asia/Shanghai)。适合前端页面时钟展示、请求签名时间戳等场景。

请求参数

本接口无需任何参数。

返回字段

字段类型说明
datetimestring当前时间,格式 Y-m-d H:i:s
timestampintUnix 时间戳(秒)
timezonestring服务器时区,固定 Asia/Shanghai
weekdaystring星期几,如 星期日

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "datetime": "2026-09-06 20:30:00",
    "timestamp": 1788777000,
    "timezone": "Asia/Shanghai",
    "weekday": "星期日"
  }
}

IP 信息查询

GET 基础服务 免费

返回调用者 IP、浏览器类型、User-Agent 等信息

/api/?p=ipinfo

功能概述

返回调用方的 IP 地址、User-Agent、识别出的浏览器类型、来源页与本次鉴权方式。常用于客户端环境检测、访问来源调试。

请求参数

本接口无需任何参数。

返回字段

字段类型说明
ipstring调用方 IP 地址
user_agentstring浏览器 User-Agent 原文,脚本调用可能为空
browserstring识别出的浏览器类型(Chrome / Edge / Firefox / Safari / 微信内置浏览器等)
refererstring请求来源页地址,可能为空
auth_viastring本次请求使用的鉴权方式:apikey(X-API-Key 或 key 参数)或 token(X-Access-Token)

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "ip": "1.2.3.4",
    "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
    "browser": "Chrome",
    "referer": "https://example.com/page",
    "auth_via": "apikey"
  }
}

每日一言

GET 基础服务 免费

从内置语料随机返回一句诗词名言

/api/?p=hitokoto

功能概述

从内置语料中随机返回一句诗词或名言,无外部依赖、响应稳定,适合个人主页签名、机器人签到语等场景。

请求参数

本接口无需任何参数。

返回字段

字段类型说明
textstring一言内容
fromstring出处(作品 / 作者)

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "text": "不积跬步,无以至千里。",
    "from": "荀子"
  }
}

UUID 生成

GET 工具类 免费

生成随机 UUID v4,支持批量(1~10 个)

/api/?p=uuid

功能概述

生成符合 RFC 4122 标准的 UUID v4 随机字符串,基于加密安全随机源,支持一次批量生成最多 10 个。

请求参数

参数类型必填说明
countint否批量生成数量,1~10,默认 1

返回字段

字段类型说明
countint实际生成数量
uuidstring / nullcount=1 时为单个 UUID 字符串,批量时为 null
listarray生成的 UUID 列表(含单条时也以数组返回)

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "count": 3,
    "uuid": null,
    "list": [
      "3f2b8c1a-9d4e-4f60-8a2b-1c9e7d5f3a01",
      "b6e4a2d0-58c3-4a91-9f77-2e8d6b4c0e59",
      "7c1f9e3b-a25d-4b68-b4c2-0d9e8f7a6b35"
    ]
  }
}

Epic 免费游戏

GET 游戏福利 1 积分/次

返回 Epic 商店正在免费 / 即将免费的游戏,缓存 30 分钟

/api/?p=epic

功能概述

返回 Epic Games 商店当前的免费游戏信息:正在免费领取中的(now)与即将开始免费的(soon)。数据来自 Epic 官方商店接口,结果缓存 30 分钟,可直接用于免费游戏推送、周报聚合页等场景。

请求参数

参数类型必填说明
typestring否all(默认)返回 now + soon;now 仅正在免费;soon 仅即将免费

返回字段

字段类型说明
updatedstring数据更新时间(北京时间)
countint本次返回的游戏总数
nowarray正在免费领取中的游戏列表
soonarray即将开始免费的游戏列表

now / soon 元素字段:

字段类型说明
titlestring游戏名称
imgstring横版封面图(Epic CDN)
linkstringEpic 商店页面链接(zh-CN)
originalstring原价展示文本,如 ¥118
startstring免费开始时间(北京时间)
endstring免费结束时间(北京时间)
hours_leftint仅 now 列表:剩余可领小时数

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "updated": "2026-09-06 21:00",
    "count": 2,
    "now": [
      {
        "title": "示例游戏 A",
        "img": "https://cdn1.epicgames.com/offer/xxx/offerImageWide.jpg",
        "link": "https://store.epicgames.com/zh-CN/p/sample-a",
        "original": "¥118",
        "start": "2026-09-04 23:00",
        "end": "2026-09-11 23:00",
        "hours_left": 122
      }
    ],
    "soon": [
      {
        "title": "示例游戏 B",
        "img": "https://cdn1.epicgames.com/offer/yyy/offerImageWide.jpg",
        "link": "https://store.epicgames.com/zh-CN/p/sample-b",
        "original": "Free",
        "start": "2026-09-11 23:00",
        "end": "2026-09-18 23:00"
      }
    ]
  }
}

常用调用示例

  • 全部:/api/?p=epic
  • 只要正在免费的:/api/?p=epic&type=now

注意事项

  • 数据来自 Epic 非官方前端接口,缓存 30 分钟;源站不可用时自动回退最近一次缓存,仍失败返回 502。
  • 免费判定以 Epic 促销价格为准(折扣价为 0),仅包含真正可免费领取的游戏。

Steam 免费游戏

GET 游戏福利 1 积分/次

返回 Steam 平台正在赠送的游戏(商店直链,已过滤有门槛活动),缓存 30 分钟

/api/?p=steam

功能概述

返回 Steam 平台当前正在赠送 / 可免费领取的游戏列表(含免费领 Key 类活动)。已自动过滤「需注册第三方账号 / 攒点数 / 关注订阅」等有门槛的赠送,并默认把链接解析为 Steam 商店直链、图片替换为 Steam CDN 原图。适合免费游戏聚合、Bot 推送等场景。

请求参数

参数类型必填说明
directstring否1(默认)解析为 Steam 商店直链 + Steam CDN 图片;0 保留源站中转链接与原图
limitint否返回条数 1~50,不传或 0 返回全部

返回字段

字段类型说明
updatedstring数据更新时间(北京时间)
countint本次返回的数量
nowarray正在赠送的游戏列表,元素字段见下表

now 元素字段:

字段类型说明
titlestring游戏名称(已去掉 Giveaway / Key 等后缀噪声)
imgstring游戏图片(默认为 Steam CDN 图片)
linkstring领取 / 商店链接(默认 Steam 商店直链)
worthstring标称价值,如 $9.99(仅供参考,不代表必为付费游戏)
endstring赠送截止时间,无期限时为 长期 / 无期限
usersint已领取人数(源站统计)

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "updated": "2026-09-06 21:00",
    "count": 1,
    "now": [
      {
        "title": "示例游戏 C",
        "img": "https://cdn.akamai.steamstatic.com/steam/apps/123456/capsule_616x353.jpg",
        "link": "https://store.steampowered.com/app/123456/",
        "worth": "$9.99",
        "end": "2026-09-12 00:00:00",
        "users": 45678
      }
    ]
  }
}

常用调用示例

  • 全部(商店直链):/api/?p=steam
  • 只要前 5 条:/api/?p=steam&limit=5
  • 保留源站中转链接:/api/?p=steam&direct=0

注意事项

  • 数据来自 GamerPower 公开接口(缓存 30 分钟),源站不可用时自动回退最近一次缓存,仍失败返回 502。
  • 商店直链解析最多处理 20 条/次刷新,防止首次调用过慢;解析失败的条目保留源站中转链接。

吾爱破解热榜

GET 社区热榜 1 积分/次

返回吾爱破解论坛当前热帖列表(标题 / 版块 / 作者 / 回复 / 查看),缓存 30 分钟

/api/?p=52pojie

功能概述

返回吾爱破解论坛当前的热帖列表(热帖指引页数据):标题、所在版块、作者、发帖时间、回复 / 查看数等,按热度排序。结果缓存 30 分钟,适合做聚合热榜、推送提醒等场景。

请求参数

参数类型必填说明
nint否返回条数 1~50,默认 20

返回字段

字段类型说明
updatedstring数据更新时间(北京时间)
countint本次返回的热帖数量
listarray热帖列表

list 元素字段:

字段类型说明
tidint帖子 ID
titlestring帖子标题
linkstring帖子直达链接
forumstring所在版块,如「精品软件区」
authorstring发帖人
datestring发帖时间
repliesint回复数
viewsint查看数
participantsint \null参与人数(源站未提供时为 null)
heatint \null热度等级(源站未标记时为 null)

返回示例

{
  "code": 200,
  "msg": "success",
  "data": {
    "updated": "2026-09-28 00:30:00",
    "count": 2,
    "list": [
      {
        "tid": 2129197,
        "title": "PDF去水印工具,无广告,不联网,全免费",
        "link": "https://www.52pojie.cn/thread-2129197-1-1.html",
        "forum": "精品软件区",
        "author": "示例作者",
        "date": "2026-9-21 11:18",
        "replies": 562,
        "views": 12264,
        "participants": 1096,
        "heat": 3
      }
    ]
  }
}

常用调用示例

  • 默认 20 条:/api/?p=52pojie
  • 只要前 5 条:/api/?p=52pojie&n=5

注意事项

  • 数据来自吾爱破解公开页面(缓存 30 分钟),源站不可用或改版时返回 502。
  • 帖子内容版权归原作者所有,请合理引用。
© 2026 API 开放平台 · 统一 API 开放平台