落雨栖 API 文档

目录导航

通用说明

可用服务

2956

院校数据

v2.0.0

API 版本

接入前提

所有接口均无需注册、无需 API Key，直接调用即可
所有接口均支持 HTTP GET 请求，返回统一为 application/json（text 格式除外）
所有接口均支持 CORS，任何来源均可跨域调用

限制与规范

项目	说明	备注
频率限制	建议单接口 QPS ≤ 10	超过可能导致请求被临时拒绝
超时时间	服务端响应超时 10s	B站接口视网络情况而定
响应格式	统一 JSON	错误响应含 `code` 与 `message` 字段
跨域支持	支持所有来源（CORS）	服务端已配置，无需额外处理
编码格式	UTF-8	所有数据均为 UTF-8 编码
HTTPS	推荐使用 HTTPS	生产环境请使用 HTTPS 调用

免责条款

服务声明

本服务为免费服务，不提供任何 SLA 保障，服务可能因维护而中断，恕不另行通知
高等院校数据来源于公开数据，仅供参考，不保证数据的实时性与准确性，请勿用于正式招生或法律用途
B站视频直链由第三方平台（Bilibili）提供，视频流经 Cloudflare Worker 代理转发，直链有效性以 B站实际为准，服务方不对链接失效负责
PV 计数器基于 SQLite 本地存储，服务器重启后数据不丢失，但若磁盘损坏或文件被删除则无法恢复
本服务严禁用于商业牟利，严禁用于任何违法用途

可用服务

高等院校 API GET

提供全国高等院校信息查询，数据覆盖 2956 所院校，包含 985/211/双一流标识

B站视频 API GET

B站视频链接解析与直链提取，本地代理 + CF Worker 双层架构，支持 BV 号、URL、b23.tv 短链，适用于 VRChat

PV 计数器 GET

网站访问量统计 API，任意站点均可接入，独立计数，SQLite 持久化

快速开始

javascript

// ── 高等院校：获取院校列表 ──
const schools = await fetch('https://api.yuki-can.top/schools.json').then(r => r.json());
const s985 = schools.data.filter(s => s['985']); // 筛选 985

// ── B站视频：解析 BV 号并获取直链 ──
// /bili 返回 302 跳转到视频直链，VRChat 可直接播放
const videoUrl = 'https://api.yuki-can.top/bili?id=BV1xx411c7XZ';
// window.location.href = videoUrl;

// 仅解析 BV 号（返回 JSON）
const res = await fetch('https://api.yuki-can.top/resolve?id=BV1xx411c7XZ').then(r => r.json());
console.log(res.bv, res.part);

// 解析 b23.tv 短链
const shortRes = await fetch('https://api.yuki-can.top/resolve?id=https://b23.tv/xxxxx').then(r => r.json());
console.log('BV:', shortRes.bv);

// ── PV 计数器：接入访问量统计 ──
fetch('https://api.yuki-can.top/counter/pv?site=example.com')
  .then(r => r.json())
  .then(d => console.log('PV:', d.count));

常见问题（FAQ）

VRChat 里播放视频怎么用？

在 VRChat 世界中的视频播放器 URL 输入框粘贴：

VRChat
https://api.yuki-can.top/bili?id=BV1xx411c7XZ
https://api.yuki-can.top/bili?id=https://b23.tv/xxxxx

也支持分P：?p=2。浏览器直接打开会下载视频文件，这是正常的——VRChat 播放器会正确处理视频流。

直链有效期限是多久？

B站直链包含时间戳签名（deadline 参数），当前解析结果有效期约 2 个月。过期后重新提取即可，不影响使用。

B站视频解析失败怎么排查？

按以下步骤排查：

确认视频是公开视频，私密/仅好友/大会员专属不支持
确认 BV 号格式正确（以 BV 开头，12 位字母数字，大小写敏感）
确认网络可以正常访问 B站
等待片刻后重试，B站接口可能有临时限流

PV 计数不累计是什么原因？

浏览器缓存：同一页面短时间内重复访问，浏览器可能走缓存不触发 fetch
广告拦截插件：部分插件会拦截 fetch 请求，.catch(()=>{}) 静默忽略
HTTPS/HTTP 混用：页面 HTTPS 请求 HTTP 会被浏览器阻止

院校数据更新频率是多久？

数据来源于公开渠道，目前为静态文件，不实时更新。如发现数据有误，属正常情况，请勿用于正式招生或法律用途。

接口支持 JSONP 或跨域吗？

所有接口均已在服务端配置 Access-Control-Allow-Origin: *，支持任意来源跨域调用，无需 JSONP。

更新日志

v2.0.0

2026-05-30

架构升级：从纯 CF Worker 迁移为「本地代理 + CF Worker 视频代理」双层架构
CDN 403 修复：新增 CF Worker 视频代理（bilibili.yuki-can.asia/video），自动添加 Referer 头绕过 B站 CDN 防盗链
/bili 接口变更：302 跳转目标从 B站 CDN 直链改为 CF Worker 视频代理，视频流量不再消耗本地服务器带宽
b23.tv 短链：所有接口（/bili、/resolve）均支持 b23.tv 短链输入，自动提取 BV 号和分P参数
/resolve 接口：新增独立端点，仅解析 BV 号返回 JSON，不请求 B站 API
进程守护：引入 PM2 进程管理，服务崩溃自动重启，开机自启
BV 号大小写：明确 BV 号为 base58 编码，服务端不做大小写转换

v1.6.0

2026-05-03

删除标准时间 API（/time 端点），服务数量从 4 调整为 3
移除标准时间相关文档、示例和 FAQ 内容
更新首页统计卡片，移除"支持时区"统计项

v1.5.0

2026-05-02

所有接口统一限流，移除无限流直连 Worker 入口
文档端点列表精简为 api.yuki-can.top/bili 和 /resolve 两个
使用示例同步更新

v1.4.0

2026-05-02

全站放弃第三方解析，仅保留官方 API（Worker 端）
vrc.yuki-can.top 前端新增每日剩余次数显示（进度条可视化）
移除 provider 参数，接口统一使用官方 API 解析
文档更新：在线调试、使用示例、错误码均同步更新

v1.3.0

2026-04-24

视觉升级为「纸质温润」设计系统 v3.1（日系清新风格）
新增 b23.tv 短链解析文档与独立说明章节
vrc 站前端支持 b23.tv 短链输入（自动转发后端解析）
补充完整移动端响应式适配（768px / 400px 断点）
修复页脚宽度不占满、CSS 规则截断等问题

v1.1.0

2026-04-21

页面拆分为 HTML + CSS + JS 三文件，结构更清晰
视觉升级为「暖雾薰衣草」配色体系
vrc、edu 站页脚新增落雨栖 API 链接

v1.0.0

2026-04-04

整合三大服务（高等院校 / B站视频 / PV计数器）为统一 API 文档
新增目录导航，完整 FAQ、版本管理、免责条款
PV 计数器服务独立为 v2.0.0，支持任意 site 参数
标准化错误码体系，补充边界场景示例

端点概览

GET /schools.json 静态文件，无参数

获取全量院校数据，返回包含 2956 条记录的 JSON 数组，建议客户端本地过滤。

院校列表接口

接口地址：https://api.yuki-can.top/schools.json

响应结构

json
{
  "total": 2956,
  "data": [
    {
      "name": "北京大学",
      "province": "北京",
      "city": "北京",
      "type": "综合",
      "level": "本科",
      "985": true,
      "211": true,
      "double_first_class": true,
      "website": "https://www.pku.edu.cn"
    }
    // ...
  ]
}

字段说明

字段	类型	说明
name	string	院校名称
province	string	所在省份
city	string	所在城市
type	string	院校类型（综合/理工/师范等）
level	string	办学层次（本科/专科）
985	boolean	是否 985 高校
211	boolean	是否 211 高校
double_first_class	boolean	是否双一流
website	string\|null	官网地址，部分院校可能为 null

使用示例

javascript

const res = await fetch('https://api.yuki-can.top/schools.json');
const { data } = await res.json();

// 过滤 985 高校
const s985 = data.filter(s => s['985']);

// 按省份筛选
const hubei = data.filter(s => s.province === '湖北');

// 搜索院校名
const pku = data.find(s => s.name.includes('北京大学'));

错误码

200 OK

成功

返回完整 JSON 数据

404 Not Found

文件不存在

请确认访问路径为 /schools.json

端点概览

GET https://api.yuki-can.top/bili 推荐

302 跳转到视频直链（经由 CF Worker 视频代理，自动处理 CDN 防盗链），VRChat 可直接播放。支持 BV 号、B站 URL、b23.tv 短链。带 IP 限流保护（20次/日，同BV不重复计数）。

GET https://api.yuki-can.top/resolve BV 解析

仅解析 BV 号和分P信息，返回 JSON { bv, part }，不请求 B站 API。支持 BV 号、B站 URL、b23.tv 短链。

GET https://bilibili.yuki-can.asia/video 视频代理

CF Worker 视频流代理，自动添加 Referer 头绕过 B站 CDN 防盗链。由 /bili 接口内部调用，一般不需要直接使用。

架构说明

v2.0 采用本地代理 + CF Worker 双层架构，将 BV 解析与视频流转发分离：

架构流程
客户端 (VRChat / 浏览器)
  │
  ├─ GET api.yuki-can.top/bili?id=BVxxx
  │   └─ 本地代理 (bili_limit_proxy)
  │       ├─ 解析 BV 号 → 请求 B站 API → 获取 CDN 直链
  │       └─ 返回 302 → bilibili.yuki-can.asia/video?url=base64(CDN直链)
  │
  ├─ GET api.yuki-can.top/resolve?id=BVxxx
  │   └─ 本地代理
  │       └─ 仅提取 BV 号和分P，返回 JSON（不请求 B站 API）
  │
  └─ GET bilibili.yuki-can.asia/video?url=xxx
      └─ CF Worker 视频代理
          ├─ 解码 CDN URL → 安全校验（仅允许 .bilivideo.com）
          ├─ 带Referer: https://www.bilibili.com/ 请求 CDN
          └─ 转发视频流给客户端（解决 CDN 403 防盗链）

为什么需要两层？

本地代理负责 BV 解析：需要 B站 Cookie（SESSDATA）以提高解析成功率，这些密钥不能放在 CF Worker
CF Worker负责视频流转发：视频流量走 CF 边缘节点，不消耗本地服务器带宽
CDN 防盗链：B站 CDN 会检查 Referer 头，VRChat 播放器不带 Referer 所以会 403。CF Worker 代理自动添加 Referer 头解决这个问题

GET /bili（主接口）

返回 HTTP 302 重定向到视频直链。经由 CF Worker 视频代理转发，自动处理 B站 CDN 防盗链（Referer 头），VRChat 可直接播放。

限流说明

次数限制：每 IP 每日 20 次请求
同 BV 去重：同一 IP 访问同一视频不重复计数
配额查询：GET /quota 可查询当前剩余次数
超限响应：HTTP 429，返回 JSON 说明剩余次数和重置时间

参数	必填	说明	示例
id	必填	BV 号 / B站视频 URL / b23.tv 短链	`BV1xx411c7XZ`
p	选填	分 P 编号（默认 1）	`2`

成功响应

http
HTTP/1.1 302 Found
Location: https://bilibili.yuki-can.asia/video?url=aHR0cHM6Ly91cG9zLXN6LW1pcnJvcmNvcy4uLg...

// 实际播放流程：
// 1. 客户端收到 302 → 跟随跳转到 CF Worker
// 2. CF Worker 添加 Referer 头请求 B站 CDN
// 3. CDN 返回视频流 → CF Worker 转发给客户端
// 4. VRChat / 浏览器开始播放视频

VRChat 使用方式

在 VRChat 世界中播放

在 VRChat 视频播放器的 URL 输入框中粘贴：

VRChat
https://api.yuki-can.top/bili?id=BV1xx411c7XZ
https://api.yuki-can.top/bili?id=BV1xx411c7XZ&p=2
https://api.yuki-can.top/bili?id=https://b23.tv/xxxxx

错误响应

json
{
  "error": "官方 API 解析失败",
  "errors": ["bilibili_official: 获取视频信息失败: 访问过于频繁..."],
  "suggestion": "请稍后重试",
  "bv": "BV1xx411c7XZ"
}

GET /resolve

仅解析 BV 号和分P信息，返回 JSON。不请求 B站 API，仅从输入中提取信息。支持 b23.tv 短链（后端跟随 302 从 Location 头提取）。

参数	必填	说明	示例
id	必填	BV 号 / B站视频 URL / b23.tv 短链	`https://b23.tv/xxxxx`

成功响应

json
// BV 号输入
{ "bv": "BV1xx411c7XZ", "part": 1 }

// b23.tv 短链输入（自动提取 BV 号和分P）
{ "bv": "BV1XY411J7aG", "part": 27 }

// B站 URL 输入（自动提取 BV 号和分P）
{ "bv": "BV1xx411c7XZ", "part": 3 }

错误响应

json
{ "error": "无法提取 BV 号，请检查输入" }

使用示例

javascript

// ── VRChat 视频播放（302 跳转到直链）──
// 直接在 VRChat 视频播放器中粘贴这个 URL
const videoUrl = 'https://api.yuki-can.top/bili?id=BV1xx411c7XZ';

// 分 P 视频
const videoUrlP2 = 'https://api.yuki-can.top/bili?id=BV1xx411c7XZ&p=2';

// b23.tv 短链也可以直接用
const videoUrlShort = 'https://api.yuki-can.top/bili?id=https://b23.tv/xxxxx';

// ── 仅解析 BV 号（返回 JSON）──
const res = await fetch('https://api.yuki-can.top/resolve?id=BV1xx411c7XZ');
const { bv, part } = await res.json();

// 解析 b23.tv 短链
const shortRes = await fetch('https://api.yuki-can.top/resolve?id=https://b23.tv/xxxxx');
const { bv: bv2, part: part2 } = await shortRes.json();
console.log('BV:', bv2, 'P:', part2);

// ── 查询剩余配额 ──
const quotaRes = await fetch('https://api.yuki-can.top/quota');
const quota = await quotaRes.json();
console.log('剩余次数:', quota.remaining, '/', quota.total);

b23.tv 短链解析

完整短链支持

所有接口均支持直接传入 b23.tv 短链，后端自动跟随 302 重定向，从 Location 头提取真实 BV 号和分P参数。

输入格式：https://b23.tv/xxxxx
支持提取分P参数：b23.tv/xxx?p=2 → part: 2
短链解析在前端通过后端 /resolve 接口完成（避免 CORS 限制）
注意：BV 号为 base58 编码，大小写敏感，服务端不会对 BV 号做大小写转换

错误码

302 Found

成功，跳转到视频直链

Location 头指向 CF Worker 视频代理地址（bilibili.yuki-can.asia/video?url=...）

429 Too Many Requests

超过每日限额

当日次数用完，次日 00:00 重置。可通过响应头 X-RateLimit-Remaining 查看剩余次数

400 Bad Request

参数缺失或格式错误

确认 id 参数存在且为有效 BV 号、B站 URL 或 b23.tv 短链

502 Bad Gateway

CDN 请求失败

B站 CDN 不可达或返回异常状态码，稍后重试

503 Service Unavailable

B站 API 异常

B站限流或视频不可用，稍后重试

响应头（限流代理）

响应头	说明
X-RateLimit-Limit	每日限额（20）
X-RateLimit-Remaining	剩余次数
X-RateLimit-BV	当前请求的 BV 号
Access-Control-Allow-Origin	CORS 允许所有来源

限制范围

以下视频无法解析

私密视频、仅好友可见视频
大会员专属视频
已被删除或下架的视频
互动视频、课程类特殊视频

GET /quota（配额查询）

查询当前 IP 的剩余配额信息，无需任何参数。返回当日已用次数、剩余次数和总限额。

GET /quota 无参数

返回当前 IP 的配额信息（按 IP 识别，基于请求来源自动判断）

响应示例

json
{
  "remaining": 18,
  "total": 20,
  "date": "2026-05-30"
}

字段说明

字段	类型	说明
remaining	number	今日剩余可用次数
total	number	每日总限额（20）
date	string	配额日期（YYYY-MM-DD），次日 00:00 自动重置

提示

配额按 IP 自动识别，基于 X-Forwarded-For / X-Real-IP / 请求来源 IP
同一 IP 请求同一 BV 号不重复计数（去重策略）
配额每天 00:00（服务器时间）自动重置
/quota 本身不计入配额消耗

实时配额

当前 IP 剩余：加载中...

在线调试

result
等待输入...

端点概览

GET /counter/pv 必填：site

获取并增加指定站点的访问量（PV）。默认每次 +1，通过 inc=0 只查询不增加。不同 site 计数完全独立。

GET /counter/meta 无参数

查询服务元信息，不计入任何计数。

GET /counter/pv

参数	必填	默认值	说明
site	必填	—	站点标识，建议用域名格式，如 `example.com`
inc	可选	1	是否计入访问量：`1` 计入（默认），`0` 仅查询

成功响应（200）

json
{ "site": "example.com", "count": 42 }

使用示例

javascript

// 接入访问量计数（每次页面加载 +1）
fetch('https://api.yuki-can.top/counter/pv?site=' + location.hostname)
  .then(r => r.json())
  .then(d => {
    document.getElementById('pv').textContent = d.count;
  })
  .catch(() => {});

// 仅查询，不计入
fetch('https://api.yuki-can.top/counter/pv?site=example.com&inc=0')
  .then(r => r.json())
  .then(d => console.log('当前PV:', d.count));

python

import requests

def get_pv(site: str, inc: bool = True) -> dict:
    url = f'https://api.yuki-can.top/counter/pv?site={site}'
    if not inc:
        url += '&inc=0'
    return requests.get(url).json()

print(get_pv('example.com'))          # 计入
print(get_pv('example.com', False))   # 仅查询

GET /counter/meta

json
{
  "service": "Luoyuqi PV Counter",
  "version": "2.0.0",
  "storage": "SQLite (local file)",
  "endpoints": {
    "GET /counter/pv?site=xxx&inc=1": "获取并增加指定站点的 PV",
    "GET /counter/meta": "服务元信息（不计入计数）"
  }
}

错误码

200 OK

成功

响应体包含 { site, count }

400 Bad Request

site 参数格式无效

site 长度 2~128 字符，仅允许字母、数字、点、连字符，首尾不能是点或连字符

500 Internal Server Error

数据库错误

SQLite 文件异常，稍后重试

技术细节

项目	说明
并发安全	SQLite UPSERT（INSERT ON CONFLICT）保证并发写入安全
数据持久化	SQLite 文件本地存储，服务重启后数据不丢失
新站点	首次调用任意 site 值自动创建记录，初始 count 为 1
频率限制	建议单 site QPS ≤ 10

落雨栖 API 文档

目录导航

通用说明

限制与规范

免责条款

可用服务

快速开始

常见问题（FAQ）

更新日志

高等院校 API

端点概览

院校列表接口

响应结构

字段说明

使用示例

错误码

B站视频 API v2.0.0

端点概览

架构说明

GET /bili（主接口）

成功响应

VRChat 使用方式

错误响应

GET /resolve

成功响应

错误响应

使用示例

b23.tv 短链解析

错误码

响应头（限流代理）

限制范围

GET /quota（配额查询）

响应示例

字段说明

实时配额

在线调试

PV 计数器 v2.0.0

端点概览

GET /counter/pv

成功响应（200）

使用示例

GET /counter/meta

错误码

技术细节