落雨栖 API 文档

目录导航

通用说明

可用服务

2956

院校数据

v1.5.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）提供，直链有效性以 B站实际为准，服务方不对链接失效负责
PV 计数器基于 SQLite 本地存储，服务器重启后数据不丢失，但若磁盘损坏或文件被删除则无法恢复
本服务严禁用于商业牟利，严禁用于任何违法用途

可用服务

高等院校 API GET

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

B站视频 API GET

B站视频链接解析与直链提取，支持 BV 号与完整 URL，适用于 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 号 ──
const res = await fetch('https://vrc.yuki-can.top/api/resolve?id=BV1xx411c7XZ').then(r => r.json());
console.log(res.url); // 视频直链

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

常见问题（FAQ）

直链有效期限是多久？

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

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

按以下步骤排查：

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

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

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

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

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

接口支持 JSONP 或跨域吗？

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

更新日志

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 跳转到 B站视频直链，跨域转发自 Worker，带 IP 限流保护（20次/日，同BV不重复计数）

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

仅解析 BV 号，返回 JSON { bv, part }，跨域转发自 Worker，带限流保护

GET /bili（主接口）

返回 HTTP 302 重定向到 B站 CDN 直链，可在浏览器/VRChat 中直接打开。通过 api.yuki-can.top 调用时自动携带限流响应头，支持跨域。

限流说明

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

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

成功响应

http
HTTP/1.1 302 Found
Location: https://cn-hljheb-ct-01-03.bilivideo.com/.../xxx.mp4?deadline=1777737893...

错误响应

json
{
  "error": "官方 API 解析失败",
  "errors": ["bilibili_official: 获取视频信息失败: 访问过于频繁..."],
  "suggestion": "请稍后重试，或提供 BILI_SESSDATA 环境变量以提高成功率",
  "bv": "BV1xx411c7XZ"
}

GET /resolve

仅解析 BV 号，返回 JSON，不发起 B站 API 请求。

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

成功响应

json
{ "bv": "BV1xx411c7XZ", "part": 1 }

使用示例

javascript

// ── 通过 api.yuki-can.top（推荐，跨域+限流）──
// 直接获取视频直链 → 302 重定向 → B站视频直链 → VRChat 可直接播放
const videoUrl = 'https://api.yuki-can.top/bili?id=BV1xx411c7XZ';
window.location.href = videoUrl;

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

// 仅解析 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 } = await shortRes.json();
console.log('BV:', bv2);

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

b23.tv 短链解析

支持短链输入

/api/resolve 接口支持直接传入 b23.tv 短链，后端会自动跟踪 302 重定向获取真实 BV 号再解析直链。

输入格式：https://b23.tv/xxxxx
短链会自动解析为 BV 号，返回格式与 BV 号输入一致
旧版 /api/bili 接口不支持短链，仅接受 BV 号

错误码

302 Found

成功，跳转到直链

Location 头包含 B站 CDN 直链

429 Too Many Requests

超过每日限额

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

400 Bad Request

参数缺失或格式错误

确认 id 参数存在且为有效 BV 号

503 Service Unavailable

B站接口异常

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

响应头（限流代理）

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

限制范围

以下视频无法解析

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

在线调试

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

端点概览

GET /bili（主接口）

成功响应

错误响应

GET /resolve

成功响应

使用示例

b23.tv 短链解析

错误码

响应头（限流代理）

限制范围

在线调试

PV 计数器 v2.0.0

端点概览

GET /counter/pv

成功响应（200）

使用示例

GET /counter/meta

错误码

技术细节