前端 CDN 资源引用与接口文档

通过固定 URL 获取开源库、版本和文件信息,也可以直接引用指定版本的 JS、CSS、字体等静态资源。

获取全部项目列表

https://www.cache123.com

返回 Cache123 当前收录的前端开源项目列表。列表中包含项目名称、显示名称、描述、项目主页、Github、NPM 和版本信息,适合用于本地索引、资源选择器或自动补全。

建议业务侧对项目列表做本地缓存,前台搜索可以优先基于缓存数据完成,减少实时请求带来的等待。


获取单个项目详情

https://www.cache123.com/[package name]

[package name] 为项目名称,例如 jqueryvueecharts。详情接口返回该项目的基础信息、可用版本和各版本文件列表。

以 jQuery 为例,可以打开 https://www.cache123.com/jquery 查看完整返回内容。


引用指定版本文件

https://js.cache123.com/[package name]/[version]/[file name]

[version] 为版本号,[file name] 为文件路径。文件路径需要使用项目详情中返回的路径,包含子目录时保留完整路径。

JavaScript 文件引用示例:

<script src="https://js.cache123.com/jquery/3.7.1/jquery.min.js"></script>

CSS 文件引用示例:

<link rel="stylesheet" href="https://js.cache123.com/animate.css/4.1.1/animate.min.css">

线上页面建议固定版本号引用资源,避免项目升级后文件内容变化影响现有页面。

常见问题

资源数据多久更新一次?

项目、版本和文件数据由同步任务定期更新。页面展示和接口返回以当前数据库中已同步、已启用的数据为准。

为什么建议固定版本号?

固定版本可以保证资源内容稳定,方便排查问题和回滚。生产环境不建议依赖“最新版本”隐式变化。

如何查找可引用的文件路径?

进入资源库项目详情页,选择版本后即可查看该版本下的文件列表和引用代码。也可以通过项目详情接口读取版本和文件数据后自行生成引用地址。