跳到主要内容
← 返回资讯

FOR DEVELOPERS & AGENTS

开放数据 API

按专业订阅音乐进修机会

高校进修目录分为声乐与器乐两大方向。每个分类都有独立的JSON和RSS地址,接收方可按需要添加订阅。项目按音乐专业归类,综合研修班可以同时出现在多个方向。

每条 message 都保留“有一点爱推送的信息”、地区、学校、项目简称和时间。转发可直接使用文案,并保留 publisher 署名和 links.web 本站项目链接。

有一点爱推送的信息:四川省-成都市-四川音乐学院-儿童音乐剧编创研修班-2026年9月19日-2026年11月20日

专业方向JSON接口RSS订阅
声乐vocal订阅声乐
美声vocal.bel-canto订阅美声
民族vocal.chinese订阅民族
流行/通俗vocal.pop订阅流行/通俗
音乐剧vocal.musical-theatre订阅音乐剧
合唱与指挥vocal.choral订阅合唱与指挥
其他声乐vocal.other订阅其他声乐
器乐instrument订阅器乐
键盘instrument.keyboard订阅键盘
管弦乐instrument.orchestral订阅管弦乐
弦乐instrument.strings订阅弦乐
木管instrument.woodwind订阅木管
铜管instrument.brass订阅铜管
打击乐instrument.percussion订阅打击乐
民族器乐instrument.chinese订阅民族器乐
其他器乐instrument.other订阅其他器乐

例如,美声使用 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 时请稍后再试。接口不接受查询参数,也没有公开写入权限。

这是小额度的资讯共享服务,不承诺持续可用。请保存已获取的资讯用于自己的阅读,避免反复下载全部历史记录。

转载或进一步核对具体事实时,请打开每条资讯的原始出处。来源网页的使用条件仍由原站决定。