FAQ
需要注册或 API Key 吗？
不需要。当前版本匿名开放，直接请求即可；未来如启用 Key 会提前在更新日志公告，旧方式会保留过渡期。
有频率限制吗？
- 单 IP 短时间高频请求可能触发 Cloudflare 质询（人机验证）
- 列表与搜索结果缓存 10 分钟，详情与歌词缓存 1 小时，正常使用（批量打标、逐首查歌词）远达不到限制阈值
- 需要全量同步时请用分页
limit=100逐页拉取，别开并发轰炸
数据多久更新一次？
与主站同一份数据库，主站每 6 小时自动构建一次；新审核通过的歌曲最迟当天可查（接口读库，实际比主站页面更快生效，边缘缓存最长延迟 1 小时）。
为什么搜索结果里没有歌词和词曲编？
两段式设计：搜索/列表只返回轻量摘要（歌名/歌手/专辑/年份/风格/封面），适合渲染选择列表；用户确认目标后再用 id 调 /v1/song/:id，一次拿到歌词、词曲编、comment 等全部数据。列表响应保持小体积，选择体验更快。
隐藏歌曲能查到吗？
能。主站上需要口令解锁的隐藏歌曲，API 同样返回其元数据与歌词——歌曲的词曲信息与歌词一并提供，方便打标。但请尊重来源，署名字符串（comment / LRC 末尾行）请随歌词一并保留。
可以商用吗？
歌词版权归各自权利人，LrcShare 只做整理与分享。API 供个人学习、本地音乐库整理、播放器歌词展示等非商业用途使用；商业使用请先联系站长（见主站关于页）。
报错 404 song not found 但主站能打开？
检查 ID 是否正确：API 的歌曲 ID 与主站歌曲页 URL 中的 ID 一致（如 /song/s_purplesoul_013）。另外歌曲若处于待审核/下架状态（非 published），API 不会返回。
支持 HTTPS / HTTP？
仅 HTTPS（https://api.lrcshare.com），HTTP 请求会被 Cloudflare 重定向。
我想接入我的播放器/脚本，支持跨域吗？
支持。所有响应带 Access-Control-Allow-Origin: *，浏览器环境直接 fetch，无需代理。