|
|
メソッド名 song.Search概要 楽曲を検索します。エンドポイント http://a.wacca.fm/api/xmlrpc文字コード UTF-8
引数 keyword (string) : タイトルに含まれるキーワードを指定します mode (string) : 検索対象を指定します。 genre (int) : ジャンルIDを入力します sub_genre (int) : サブジャンルIDを入力します copyright (string) : 著作権のタイプを指定します copyright_commercial () : クリエイティブコモンズによる著作権で営利目的使用可否を指定します。 copyright_modifications () : クリエイティブコモンズによる著作権、改変の許可を指定します。 order (string) : 'date'=登録日時順(降順) ,'play'=試聴数順(降順) , 'recommend'=レコメンド数順(降順) limit (int) : 結果セットの上限数を指定します。省略時100件、最大1000件 offset (int) : 結果セットのオフセットを指定します。省略時0 song_id (int) : 楽曲ID artist_id (int) : アーティストID artist_name (string) :アーティスト名 song_title (string) : 楽曲タイトル song_genre (string) : wacca指定のジャンル名 song_sub_genre (string) : サブジャンル名 song_style (string) : 楽曲スタイル artist_style (string) : アーティストのスタイル song_comment (string) : アーティスト自身のコメント song_credit (string) : 著作者の記述 song_duration (int) : 演奏時間(秒) play_count (int) : 試聴数 download_count (int) : ダウンロード数 recommend_count (int) : レコメンド数 channel (int) : チャンネル数 bitrate (int) : ビットレート samplingrate (int) : サンプリングレート copyright (string) : ライセンスの型 copyright_commercial (string) : 営利目的利用の可否 copyright_modifications (string) : 翻案・改変の可否 regist_date (dateTime.iso8601) : 登録日時 img_url (string) : ジャケット画像のURL img_thumb_url (string) : ジャケット画像のURL(サムネイル) mp3_url (string) : mp3のURL asx_url (string) : asxのURL url (string) : 楽曲詳細ページのURL サンプル リクエストサンプル
<?xml version="1.0"?>
<methodCall>
<methodName>song.Search</methodName>
<params>
<param>
<value>
<struct>
<member>
<name>keyword</name>
<value><string>キーワード</string></value>
</member>
<member>
<name>mode</name>
<value><string>song_title/genre_freeword/artist_style/favorite_artist</string></value>
</member>
<member>
<name>genre</name>
<value><int>###</int></value>
</member>
<member>
<name>sub_genre</name>
<value><int>###</int></value>
</member>
<member>
<name>copyright</name>
<value><string>all/normal/creativecommons</string></value>
</member>
<member>
<name>copyright_commercial</name>
<value><string>yes/no</string></value>
</member>
<member>
<name>copyright_modifications</name>
<value><string></string>yes/no/share</value>
</member>
<member>
<name>order</name><value>
<string>play/recommend/date</string></value>
</member>
<member>
<name>limit</name>
<value><int>###</int></value>
</member>
<member>
<name>offset</name>
<value><int>###</int></value>
</member>
</struct>
</value>
</param>
</params>
</methodCall>
レスポンスサンプル
<?xml version="1.0"?>
<methodResponse>
<params>
<param>
<value>
<struct>
<member>
<name>song_id</name>
<value><int>###</int></value>
</member>
<member>
<name>artist_id</name>
<value><int>###</int></value>
</member>
<member>
<name>artist_name</name>
<value><string>アーティスト名</string></value>
</member>
<member>
<name>song_title</name>
<value><string>楽曲タイトル</string></value>
</member>
<member>
<name>song_genre</name>
<value><string>ジャンル名</string></value>
</member>
<member>
<name>song_sub_genre</name>
<value><string>サブジャンル名</string></value>
</member>
<member>
<name>song_style</name>
<value><string>楽曲スタイル</string></value>
</member>
<member>
<name>artist_style</name>
<value><string>アーティストのスタイル</string></value>
</member>
<member>
<name>song_comment</name>
<value><string>アーティスト自身のコメント</string></value>
</member>
<member>
<name>song_credit</name>
<value><string>作者等の記述</string></value>
</member>
<member>
<name>song_duration</name>
<value><int>###</int></value>
</member>
<member>
<name>play_count</name>
<value><int>###</int></value>
</member>
<member>
<name>download_count</name>
<value><int>###</int></value>
</member>
<member>
<name>recommend_count</name>
<value><int>###</int></value>
</member>
<member>
<name>channel</name>
<value><int>###</int></value>
</member>
<member>
<name>bitrate</name>
<value><int>###</int></value>
</member>
<member>
<name>samplingrate</name>
<value><int>###</int></value>
</member>
<member>
<name>copyright</name>
<value><string>normal/creativecommons</string></value>
</member>
<member>
<name>copyright_commercial</name>
<value><string>yes/no</string></value>
</member>
<member>
<name>copyright_modifications</name>
<value><string>yes/no</string></value>
</member>
<member>
<name>regist_date</name>
<value><dateTime.iso8601>登録日時</dateTime.iso8601></value>
</member>
<member>
<name>img_url</name><value>
<string>ジャケット画像のURL</string></value>
</member>
<member>
<name>img_thumb_url</name>
<value><string>ジャケット画像のURL(サムネイル)</string></value>
</member>
<member>
<name>mp3_url</name><value>
<string>mp3のURL</string></value>
</member>
<member>
<name>asx_url</name>
<value><string>asxのURL</string></value>
</member>
<member>
<name>url</name>
<value><string>楽曲詳細ページのURL</string></value>
</member>
</struct>
</value>
</param>
</params>
</methodResponse>
エラーコードサンプル
<?xml version="1.0"?>
<methodResponse>
<fault>
<value>
<struct>
<member>
<name>faultCode</name>
<value><int>-1</int></value>
</member>
<member>
<name>faultString</name>
<value><string>TOO_LONG_STRING</string></value>
</member>
</struct>
</value>
</fault>
</methodResponse>
1件もヒットしなかった場合
<?xml version="1.0"?>
<methodResponse>
<fault>
<value>
<struct>
<member>
<name>faultCode</name>
<value><int>-2</int></value>
</member>
<member>
<name>faultString</name>
<value><string>NO_RESULT</string></value>
</member>
</struct>
</value>
</fault>
</methodResponse>
ジャンルIDが不正な場合
<?xml version="1.0"?>
<methodResponse>
<fault>
<value>
<struct>
<member>
<name>faultCode</name>
<value><int>-3</int></value>
</member>
<member>
<name>faultString</name>
<value><string>INVALID_ID</string></value>
</member>
</struct>
</value>
</fault>
</methodResponse>
[waccaAPIについて]に戻る |