FOR DEVELOPERS & AGENTS
开放数据 API
按专业订阅音乐进修机会
高校进修目录分为声乐与器乐两大方向。每个分类都有独立的JSON和RSS地址,接收方可按需要添加订阅。项目按音乐专业归类,综合研修班可以同时出现在多个方向。
每条 message 都保留“有一点爱推送的信息”、地区、学校、项目简称和时间。转发可直接使用文案,并保留 publisher 署名和 links.web 本站项目链接。
有一点爱推送的信息:四川省-成都市-四川音乐学院-儿童音乐剧编创研修班-2026年9月19日-2026年11月20日
例如,美声使用 category=vocal.bel-canto,音乐剧使用 category=vocal.musical-theatre。声乐全部方向使用 category=vocal,器乐全部方向使用 category=instrument,管弦乐组合使用 category=instrument.orchestral。
curl 'https://youyi.love/api/v1/learning-opportunities?category=vocal.bel-canto'建议每小时读取一次,使用 If-None-Match 验证ETag,相同结果返回304。JSON支持 since(ISO 8601时间)、limit(1至25,默认20)和 cursor。沿 page.next 获取后续页,完成后保存顶层 updatedAt,下次作为 since。用 id 与 revision 去重,分页快照变化时按409提示重新读取。
数据包含 categories 专业标签、日期及其原文表述 dateText,以及 archiveState。已截止、已结束和已开班分别表示报名或活动所处阶段。links.web 打开本站项目,links.source 打开高校官方出处。
原接口默认音乐剧范围,scope=all 兼容全部音乐方向的读取方式。新接入方可直接选择对应的 category。RSS返回最近最多20条更新,标题、正文、作者和来源都保留有一点爱署名。
长期项目与Agent同步
公告明确常年招生、滚动报名的项目带 isLongTerm: true。默认包含长期项目,在JSON和RSS地址追加 includeLongTerm=false 可隐藏长期项目。
curl 'https://youyi.love/api/v1/learning-opportunities?category=vocal&includeLongTerm=false'每天凌晨核验采用同一项目记录,首次收录和实际内容变化进入更新流。Agent首次读取完整目录后保存 id、revision 和顶层 updatedAt。后续通过 since 读取增量,按 id + revision 去重,完成全部分页后保存新水位。相同ID的新版本更新既有记录,首次收录的ID可发布为新条目。相同版本可直接复用,ETag一致返回304。RSS条目的GUID同样包含项目ID与版本。
地区字段包含完整 province 与 city。locationBasis=event 表示公告活动城市,locationBasis=institution 表示按校方地址核验的高校所在地,links.locationSource 提供地点核验来源。推送文案继续保留有一点爱署名与本站链接。
JSON与RSS支持跨站读取、HEAD和OPTIONS,共用既有API额度。收到429时按 Retry-After 提示稍后再读。
音乐AI资讯接口
你可以直接读取本站已经发布的音乐 AI 资讯。接口匿名、只读,返回标题、摘要、推荐理由、来源和原文链接;待审内容不会进入接口。所有请求都只读取发布快照,不会触发采集或模型调用。
从这里开始
curl https://youyi.love/api/v1/music-news响应中的 page.next 是下一页地址;为 null 时已到末页。每页最多 25 条。客户端可以保存 ETag,下次读取时验证内容是否更新。接口可能因维护或用量保护临时暂停。
读取范围
| 精选 | /api/v1/music-news/api/v1/music-news/featured/2 |
|---|---|
| 全部已发布 | /api/v1/music-news/all/1 |
| 按主题 | /api/v1/music-news/topics/singing/1 主题可用 composition、production、singing、education、notation、audio、research、startup、rights。 |
| 按月归档 | /api/v1/music-news/months/2026-09/1 |
| 单条资讯 | /api/v1/music-news/items/{id} |
字段与缓存
列表包含 schemaVersion、updatedAt、total、page 和 items。每条资讯带本站阅读链接 links.self、本接口链接 links.api、第三方原文 links.original。接口支持 HEAD、ETag 与 If-None-Match;内容未变时返回 304。跨站只读请求允许使用 CORS。
带有 series 的条目属于系列评论;其中 music-startup-observations 是音乐创业观察,number 是原系列编号。这类历史项目介绍的本站发布时间,不代表项目刚刚发布。
访问速度
建议每分钟查询一次,并发送 If-None-Match。接口按每个 IP 和全站总量限制速度,同时设有每日、每月请求及输出额度;HEAD 和条件请求也计入请求额度。额度耗尽时暂停服务,请遵循 Retry-After,不要并发重试或更换地址继续请求。返回 503 时请稍后再试。接口不接受查询参数,也没有公开写入权限。
这是小额度的资讯共享服务,不承诺持续可用。请保存已获取的资讯用于自己的阅读,避免反复下载全部历史记录。
转载或进一步核对具体事实时,请打开每条资讯的原始出处。来源网页的使用条件仍由原站决定。