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

 

 

ワッカ【WACCA music is SuperUnkown】

キャラクターイメージ

栗山米菓

info by listen

イマココ

ヘルプメニュー

APIとは?

メソッド名

 song.getInfo

概要

 任意の楽曲の情報を取得します。

エンドポイント

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

文字コード

 UTF-8

引数

song_id (int) : 楽曲IDを指定する

 
戻り値

song_id (int) : 楽曲ID

artist_id (int) : アーティストID

artist_name (string) : アーティスト名

song_title (string) : 楽曲タイトル

song_genre (string) : ジャンル名

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 (date) : 登録日時

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.getInfo</methodName>
  <params>
    <param>
      <value><int>###</int></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>INVALID_ID</string></value>
        </member>
      </struct>
    </value>
  </fault>
</methodResponse> 

 

▲ページのトップに戻る

 

[waccaAPIについて]に戻る