search/sub 搜索子条目

根据关键词搜索子条目,包括搜索章节(ep)、曲目(song)。

URL

支持格式

  • JSON
  • XML

HTTP请求方式

GET

认证方式

  • API Key 认证
  • OAuth 认证

请求参数

必填 类型 默认值 说明
keyword true string null 搜索关键词,多个关键词以空格隔开。
sub_type false string null 子条目类型,多个类型以半角逗号隔开。
page false int 1 当前页数。
perpage false int 20 每页条目数,取值范围为 [1, 50]。

返回结果

  • 接口将返回包含指定关键字的子条目,包括子条目的详细信息、子条目所属条目的详细信息。
  • 若子条目 sub_type=song ,还将在每个子条目对象中包括 sub_upload 对象,以返回曲目 mp3 的信息。
  • 若已进行 OAuth 登录,还将返回当前登录用户对每个子条目、条目的 fav 收藏对象。

例:搜索 song 类型的子条目,关键词为“研究所”。

GET http://api.moefou.org/search/sub.json?sub_type=song&keyword=研究所

{
  "response":{
    "information":{
      "parameters":{
        "sub_type":"song",
        "keyword":"\u7814\u7a76\u6240" // 搜索关键字“研究所”
      },
      "msg":[ ],
      "has_error":false,
      "request":"\/search\/sub.json?sub_type=song&keyword=%E7%A0%94%E7%A9%B6%E6%89%80",
      "page":1, // 当前页数
      "perpage":20, // 每页数量
      "count":13 // 搜索结果数量
    },
    "subs":[ // 子条目对象们
      {
        "sub_id":75531,
        "sub_parent_wiki":9365,
        "sub_parent":0,
        "sub_title":"\u690d\u677e\u4f38\u592b - \u9b54\u5c0e\u7814\u7a76\u6240",
        "sub_title_encode":"zhisongshenfumodaoyanjiusuo",
        "sub_type":"song",
        "sub_order":"44",
        "sub_meta":null,
        "sub_about":"",
        "sub_data":null,
        "sub_date":978624000,
        "sub_modified":1330816673,
        "sub_url":"http:\/\/moefou.org\/sub\/song\/75531",
        "sub_fm_url":"http:\/\/moe.fm\/song\/75531",
        "sub_view_title":"song.44 \u690d\u677e\u4f38\u592b - \u9b54\u5c0e\u7814\u7a76\u6240",
        "wiki":{ // 子条目所属条目
          "wiki_id":9365,
          "wiki_title":"Final Fantasy VI: Original Sound Version",
          "wiki_title_encode":"finalfantasyvi:originalsoundversion",
          "wiki_name":"9365",
          "wiki_type":"music",
          "wiki_parent":0,
          "wiki_date":978624000,
          "wiki_modified":1330815496,
          "wiki_modified_user":5943,
          "wiki_meta":null,
          "wiki_fm_url":"http:\/\/moe.fm\/music\/9365",
          "wiki_url":"http:\/\/moe.fm\/music\/9365",
          "wiki_cover":{
            "small":"http:\/\/nyan.moefou.org\/wiki_cover\/000\/00\/93\/000009365_96.jpg",
            "medium":"http:\/\/nyan.moefou.org\/wiki_cover\/000\/00\/93\/000009365_144.jpg",
            "square":"http:\/\/nyan.moefou.org\/wiki_cover\/000\/00\/93\/000009365_192.jpg",
            "large":"http:\/\/nyan.moefou.org\/wiki_cover\/000\/00\/93\/000009365.jpg"
          },
          "wiki_user_fav":null // 当前用户未收藏该条目
        },
        "sub_user_fav":null, // 当前登录用户未收藏该子条目
        "sub_upload":[ // 因为子条目类型为 song,故还会有 sub_upload 对象,以返回曲目的 mp3 情况
          {
            "up_id":16364,
            "up_uid":5943,
            "up_obj_id":75531,
            "up_obj_type":"song",
            "up_uri":"\/e\/0\/cb\/e04406f4697bdcbb9e69343cc6587747.mp3",
            "up_type":"mp3",
            "up_md5":"e0cba40aa4200662a17215aac5633371",
            "up_size":1207,
            "up_data":{
              "bitrate":64,
              "length":167.258,
              "time":"02:47",
              "filesize":1235136
            },
            "up_date":1330816832,
            "up_url":"http:\/\/moefm.b0.upaiyun.com\/e\/0\/cb\/e04406f4697bdcbb9e69343cc6587747.mp3"
          }
        ]
      },
      ...... // 省略显示其他sub对象
    ]
  }
}
api/search/sub.txt · 最后更改: 2015-01-09 22:32 (外部编辑)