电台站外传送门

允许通过在 URL 中加入相关定位参数(如专辑标题),使链接直接定位到某一专辑页面或其播放页面。这条 API 的使用场景通常是在第三方网站中挂载跳转链接。

URL

支持格式

  • JSON
  • XML
  • HTML

HTTP请求方式

GET

认证方式

None 认证

请求参数

必填 取值 默认值 说明
api false json or xml null 是否以格式化结构返回结果。若留空,则直接跳转到对应网页中。
listen false 0 or 1 0 是否直接指向播放页面,而不是专辑页面。
title false string null 按标题定位专辑,标题需要完全匹配。
bgm_id false int null 按 Bangumi 条目 id 定位专辑。

使用说明

系统将根据输入的定位参数(title 及 bgm_id),查找相匹配的专辑,并返回相应 URL。逻辑如下:

  • 若未输入定位参数,则 URL = http://moe.fm/
  • 若查找结果数量为 0,则 URL = http://moe.fm/search?q={title},即正统搜索页面;
  • 若查找结果数量为 1 且 listen==0,则 URL = {wiki_url},即专辑页面;
  • 若查找结果数量为 1 且 listen==1,则 URL = http://moe.fm/listen?music={wiki_id},即播放专辑的页面;
  • 若查找结果数量为 1,但专辑内没有可播放的曲目,则 URL = {wiki_url};
  • 若查找结果数量大于等于 2,则 URL = http://moe.fm/search?q={title},即正统搜索页面。

返回结果

例 1

direct_example1.html
<a href="http://moe.fm/search/direct?title=东方风神录">到萌否电台浏览《东方风神录》专辑</a>

用户点击此链接将跳转到 http://moe.fm/music/8803

例 2

GET http://moe.fm/search/direct?api=json&title=东方风神录

direct_example2.json
{
  response: {
    has_wiki: true, // 成功定位到唯一专辑
    has_mp3: true, // 专辑内有可播放的曲目
    url: "http://moe.fm/music/8803" // 专辑页面
  }
}

例 3

GET http://moe.fm/search/direct?api=json&listen=1&title=东方风神录

direct_example3.json
{
  response: {
    has_wiki: true, // 成功定位到唯一专辑
    has_mp3: true, // 专辑内有可播放的曲目
    url: "http://moe.fm/listen?music=8803" // 专辑播放页面
  }
}

例 4

GET http://moe.fm/search/direct?api=json&title=白金

direct_example4.json
{
  response: {
    has_wiki: false, // 无法定位到唯一专辑
    has_mp3: false,
    url: "http://moe.fm/search?q=白金" // 指向搜索页面
  }
}
moe.fm/api/search/direct.txt · 最后更改: 2015-01-09 22:32 (外部编辑)