アイコン音楽ダウンロード+配信+コミュニティサイト

 

 

ワッカ【WACCA music is SuperUnkown】

キャラクターイメージ

栗山米菓

info by listen

イマココ

ヘルプメニュー

APIとは?

メソッド名

 song.Search

概要

 楽曲を検索します。

エンドポイント

 http://a.wacca.fm/api/xmlrpc

文字コード

 UTF-8

引数

keyword (string) : タイトルに含まれるキーワードを指定します

mode (string) : 検索対象を指定します。
  省略時'song_title','song_title'=楽曲タイトル、'genre_freeword'=楽曲の詳細、
  'artist_style'=アーティストの音楽スタイル、'favorite_artist'=尊敬するアーティスト、
  'song_comment'=アーティスト自身のコメント

genre (int) : ジャンルIDを入力します
  省略時'0','0'=全て、'1'=ポップス、'2'=ロック、'3'=ブルース/ジャズ/フュージョン、
  '4'=R&B/ソウル、'5'=クラブ/エレクトロニカ/テクノ、'6'=インストゥルメンタル/クラシック、
  '7'=ワールド、'8'=音素材・その他

sub_genre (int) : サブジャンルIDを入力します
  省略時'0','0'=全て(ジャンルIDが0の場合は無視される)

copyright (string) : 著作権のタイプを指定します
  (all'=通常の著作権とCCライセンスのもの全て , 'nomal'=通常の著作権のもののみ ,
  'creativecommons'=クリエイティブコモンズライセンスのもののみ)

copyright_commercial () : クリエイティブコモンズによる著作権で営利目的使用可否を指定します。
  ('copyright'パラメータに'creativecommons'を指定したときのみ有効)
  yes'=使用可能 , 'no'=使用禁止

copyright_modifications () : クリエイティブコモンズによる著作権、改変の許可を指定します。
  ('copyright'パラメータに'creativecommons'を指定したときのみ有効)
  'yes'=派生可 , 'no'=派生禁止 , 'share'=同一条件承諾

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) : ライセンスの型
  (normal: ライセンスなし、または creativecommons: クリエイティブコモンズ)

copyright_commercial (string) : 営利目的利用の可否
  (クリエイティブコモンズの場合のみ)営利目的利用の可否('yes' または 'no')

copyright_modifications (string) : 翻案・改変の可否
  (クリエイティブコモンズの場合のみ)翻案・改変の可否('yes' または 'no' または 'share')

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>

 

エラーコードサンプル
検索ワードが64文字以上存在する場合

<?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について]に戻る