ランキング
新着

zoome API(XML-RPC)ドキュメント

本ドキュメントは、zoome動画共有サイト(以下zoomeと呼称)において提供するAPI機能の仕様について記載するものとなります。
■APIご利用についての注意事項
本APIは、以下の点をご了承の上、ご利用ください。
  • 本APIは、必ずzoomeのご利用規約をご覧になり、同意した上でご利用ください。
  • 本APIはβ版として試験的に公開されているものであり、APIの仕様変更ならびに APIの公開停止を予告なしに行う場合があります。
  • 本APIへのリクエストに際して、1クライアントあたりの上限回数等は特に設定しておりませんが、システムの安定稼動に影響を与えると弊社が判断した場合には、特定のクライアントからのアクセスを予告なく停止する場合がございます。
▼APIのURI(エンドポイント)
http://up.zoome.jp/xmlrpc
▼インターフェース
zoome.login ログインします。
zoome.getUserInfo zoome会員の基礎情報を返します。
zoome.getThemeList テーマ(カテゴリ)名のリストを返します。
zoome.newPost 日記(動画)を投稿します。
zoome.deletePost 日記(動画)を削除します。
zoome.getDiaryInfo 日記の情報を返します。
zoome.getDiaryList 日記のリストを返します。
zoome.getMovieInfo 動画の情報を返します。
zoome.getMovieList 動画のリストを返します。
zoome.tagSearch タグ名で検索します。
▼サンプルコードについて
perlのFrontier::Clientモジュールを使用する前提で記載しています。
インスタンス化する際のコードは下記になります。
my $server = Frontier::Client->new({
    url => 'http://up.zoome.jp/xmlrpc',
});
▼その他
文字コードはutf-8となります。
■zoome.login
▼説明
メールアドレスとパスワードにて認証しセッションを返します。
認証失敗時はsessionは空です。
▼引数
項目名 必須 デフォルト 説明
string mailaddr   メールアドレス
string password   パスワード
▼返り値
項目名 説明
string session セッション
my $method = 'zoome.login';
my $apiarg = ({
    mailaddr => 'account@host.com',
    password => 'foo',
});
my $result = $server->call($method, $apiarg);
if ($result->{session}) {
    # login ok
}
else {
    # login error
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.login</methodName>
<params>
<param><value><struct>
<member><name>mailaddr</name><value><string>account@host.com</string></value></member>
<member><name>password</name><value><string>foo</string></value></member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>session</name><value><string>xxxxxxxx</string></value></member>
</struct></value>
</param>
</params>
</methodResponse>
■zoome.getUserInfo
▼説明
会員基礎情報を返します。
取得できなかった場合は空です。
▼引数
項目名 必須 デフォルト 説明
i4 zoomeid     zoomeの会員ID
string zoomeurl     マイページのURLネーム
※zoomeidとzoomeurl何れかを指定して下さい。両方指定した場合はzoomeidを優先します。
▼返り値
項目名 説明
i4 zoomeid zoomeの会員ID
string zoomeurl マイページのURLネーム
string nickname ニックネーム
string mytitle マイページタイトル
string myurl ページアドレス(http://zoome.jp/{zoomeurl}/)
array imageurl プロフィール画像([0]:small [1]:middle [2]:large)
my $method = 'zoome.getUserInfo';
my $apiarg = ({
    zoomeurl => 'zoome',
});
my $result = $server->call($method, $apiarg);
if ($result) {
    printf("zoomeid: %s¥n",$result->{zoomeid});
    printf("zoomeurl: %s¥n",$result->{zoomeurl});
    printf("nickname: %s¥n",$result->{nickname});
    printf("mytitle: %s¥n",$result->{mytitle});
    printf("myurl: %s¥n", $result->{myurl});
    printf("image_small: %s¥n", $result->{imageurl}[0]);
    printf("image_middle: %s¥n", $result->{imageurl}[1]);
    printf("image_large: %s¥n", $result->{imageurl}[2]);
}
else {
    # no data
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.getUserInfo</methodName>
<params>
<param><value><struct>
<member><name>zoomeurl</name><value><string>zoome</string></value></member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>imageurl</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>mytitle</name><value><string>zoome-kunといっしょ</string></value></member>
<member><name>zoomeid</name><value><i4>1</i4></value></member>
<member><name>nickname</name><value><string>zoome-kun</string></value></member>
<member><name>myurl</name><value><string>http://zoome.jp/zoome/</string></value></member>
<member><name>zoomeurl</name><value><string>zoome</string></value></member>
</struct></value>
</param>
</params>
</methodResponse>
■zoome.getThemeList
▼説明
テーマ(カテゴリ)のリストを返します。
引数themeidを省略した場合は全てのリスト(構造体配列)を返します。
取得できなかった場合は空です。
▼引数
項目名 必須 デフォルト 説明
i4 themeid     テーマID
▼返り値(themeid指定時)
項目名 説明
i4 themeid テーマID
string themename テーマ名
▼返り値(themeid省略時)
項目名 説明
array   配列
    struct   構造体
        i4 themeid テーマID
        string themename テーマ名
## テーマID指定
my $method = 'zoome.getThemeList';
my $apiarg = ({
    themeid => 1,
});
my $result = $server->call($method, $apiarg);
if ($result) {
    printf(qq{themeid: %d¥n}, $result->{themeid});
    printf(qq{themename: %s¥n}, $result->{themename});
}

## テーマリスト取得
$result = $server->call($method);
for my $row (@{$result}) {
    printf("themeid: %d¥n", $row->{themeid});
    printf("themename: %s¥n", $row->{themename});
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.getThemeList</methodName>
<params>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><array><data>
<value><struct>
<member><name>themeid</name><value><i4>1</i4></value></member>
<member><name>themename</name><value><string>生活・家族</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>2</i4></value></member>
<member><name>themename</name><value><string>グルメ・クッキング</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>3</i4></value></member>
<member><name>themename</name><value><string>ペット・動物</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>4</i4></value></member>
<member><name>themename</name><value><string>健康・スポーツ </struct></value>
<value><struct>
<member><name>themeid</name><value><i4>5</i4></value></member>
<member><name>themename</name><value><string>スクープ・目撃</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>6</i4></value></member>
<member><name>themename</name><value><string>パーソナル・日記・ブログ</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>7</i4></value></member>
<member><name>themename</name><value><string>友達・仲間・グループ</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>8</i4></value></member>
<member><name>themename</name><value><<string>文化・教養</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>9</i4></value></member>
<member><name>themename</name><value><string>地域・旅行・レジャー</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>10</i4></value></member>
<member><name>themename</name><value><string>趣味・エンタメ</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>11</i4></value></member>
<member><name>themename</name><value><string>クルマ・バイク・乗り物</string></value></member>
</struct></value>
<value><struct>
<member><name>themeid</name><value><i4>12</i4></value></member>
<member><name>themename</name><value><string>音楽・芸術・クリエイター</string></value></member>
</struct></value>
</data></array></value>
</param>
</params>
</methodResponse>
■zoome.newPost
▼説明
日記(動画)を投稿します。
投稿に成功した場合は日記ID(diaryid)に1以上の値が返ります。
失敗した場合はdiaryidは0となり、errorにエラーメッセージが格納されます。
▼引数
項目名 必須 デフォルト 説明
string session   セッション(zoome.loginの返り値)
string title   無題 タイトル
string body   本文
i4 themeid   1 テーマID
array tagname   タグ名(1〜6個)
string publictype   all 公開設定
[all]:全体に公開 [friend]:メイトに公開 [private]:非公開
boolean iscomment   1 コメントの許可 [1]:許可する [0]:許可しない
boolean isvote   1 投票の許可 [1]:許可する [0]:許可しない
boolean istagpaste   1 プレイヤー貼り付けの許可 [1]:許可する [0]:許可しない
struct movie     ▽動画アップ時に指定(500Mまで)
    base64 bin     動画データ(base64符号化)
    string suffix     動画ファイルの拡張子またはファイル名
struct image1     ▽画像1アップ時に指定(10Mまで)
    base64 bin     画像1データ(base64符号化)
    string suffix     画像1ファイルの拡張子またはファイル名
struct image2     ▽画像2アップ時に指定(10Mまで)
    base64 bin     画像2データ(base64符号化)
    string suffix     画像2ファイルの拡張子またはファイル名
struct image3     ▽画像3アップ時に指定(10Mまで)
    base64 bin     画像3データ(base64符号化)
    string suffix     画像3ファイルの拡張子またはファイル名
▼返り値
項目名 説明
i4 diaryid 日記ID
string error エラー理由(diaryidがゼロの時のみ)
use MIME::Base64 qw(encode_base64);

my $method = 'zoome.login';
my $apiarg = ({
    mailaddr => 'account@host.com',
    password => 'foo',
});
my $result = $server->call($method, $apiarg);
if (!$result->{session}) {
    exit;
}
my $session = $result->{session};

$method = 'zoome.newPost';
my $title = 'うちのワンコ';
my $body = '今日も元気です!';
my $themeid = 3;
my @tagname = ('日記', 'ペット', 'ワンコ');
my $publictype = 'all';
my $iscomment = 1;
my $isvote = 1;
my $istagpaste = 1;

my $movie_bin = undef;
my $movie_file = 'sample.avi'; # 動画ファイルを指定
my $movie_size = (-s $movie_file);
open(IN, $movie_file);
binmode(IN);
sysread(IN, $movie_bin, $movie_size);
close(IN);
my $movie = ({
    bin => $server->base64(encode_base64($movie_bin)),
    suffix => $movie_file,
});

my $image1_bin = undef;
my $image1_file = 'sample.jpg'; # 画像ファイルを指定
my $image1_size = (-s $image1_file);
open(IN, $image1_file);
binmode(IN);
sysread(IN, $image1_bin, $image1_size);
close(IN);
my $image1 = ({
    bin => $server->base64(encode_base64($image1_bin)),
    suffix => $image1_file,
});

$apiarg = ({
    session => $session,
    title => $title,
    body => $body,
    themeid => $themeid,
    tagname => \@tagname,
    publictype => $publictype,
    iscomment => $server->boolean($iscomment),
    isvote => $server->boolean($isvote),
    istagpaste => $server->boolean($istagpaste),
    movie => $movie,
    image1 => $image1,
#    image2 => $image2,
#    image3 => $image3,
});
$result = $server->call($method, $apiarg);
if ($result->{diaryid}) {
    ## 投稿成功
    printf("diaryid: %d\n", $result->{diaryid});
}
else {
    ## 投稿失敗
    printf("error: %s\n", $result->{error});
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.newPost</methodName>
<params>
<param><value><struct>
<member><name>iscomment</name><value><boolean>1</boolean></value>
</member>
<member><name>publictype</name><value><string>all</string></value></member>
<member><name>body</name><value><string>今日も元気です!</string></value></member>
<member><name>istagpaste</name><value><boolean>1</boolean></value>
</member>
<member><name>image1</name><value><struct>
<member><name>bin</name><value><base64>/9j/4AAQSkZJRgABAgAAZABkAAD/7AARRHVja3
kAAQAEAAAAZAAA/+IMVElDQ19QUk9GSUxFAAEB
AAAMRFVDQ00CQAAAbW50clJHQiBYWVogB9MABAAEAAAAAAAAYWNzcE1TRlQAAAAAQ0FOT
1owMDkA
...画像1ファイルです。省略します。
</base64></value>
</member>
<member><name>suffix</name><value><string>sample.jpg</string></value></member>
</struct></value>
</member>
<member><name>movie</name><value><struct>
<member><name>bin</name><value><base64>AAAAHGZ0eXBtbXA0AAAAAW1tcDQzZ3A1M2dwN
AAAHXxtb292AAAAbG12aGQAAAAAwnLs7sJy7O4A
AAJYAAA/5gABAAABAAAAAAAAAAAAAAAAAQAAAAAAAAAAAAAAAAAAAAEAAAAAAAAA
AAAAAAAAAEAA
...動画ファイルです。省略します。
</base64></value>
</member>
<member><name>suffix</name><value><string>sample.avi</string></value></member>
</struct></value>
</member>
<member><name>isvote</name><value><boolean>1</boolean></value>
</member>
<member><name>session</name><value><string>xxxxxxxxxxxxx</string></value></member>
<member><name>themeid</name><value><i4>3</i4></value></member>
<member><name>title</name><value><string>うちのワンコ</string></value></member>
<member><name>tagname</name><value><array><data>
<value><string>日記</string></value><value><string>ペット</string></value><value><string>ワンコ</string></value></data></array></value>
</member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>diaryid</name><value><i4>5</i4></value></member>
<member><name>error</name><value><string></string></value></member>
</struct></value>
</param>
</params>
</methodResponse>
■zoome.deletePost
▼説明
日記(動画)を削除します。
正常時はstatusに1が返ります。
失敗した場合はstatusはゼロとなり、errorにエラーメッセージが格納されます。
▼引数
項目名 必須 デフォルト 説明
string session   セッション(zoome.loginの返り値)
i4 diaryid   削除する日記ID
▼返り値
項目名 説明
i4 status 実行結果
string error エラー理由(statusがゼロの時のみ)
my $method = 'zoome.login';
my $apiarg = ({
    mailaddr => 'account@host.com',
    password => 'foo',
});
my $result = $server->call($method, $apiarg);
if (!$result->{session}) {
    exit;
}
my $session = $result->{session};

$method = 'zoome.deletePost';
$apiarg = ({
    session => $session,
    diaryid => 5,
});
$result = $server->call($method, $apiarg);
if ($result->{status}) {
    ## 削除成功
}
else {
    ## 削除失敗
    printf("error: %s\n", $result->{error});
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.deletePost</methodName>
<params>
<param><value><struct>
<member><name>diaryid</name><value><i4>5</i4></value></member>
<member><name>session</name><value><string>xxxxxxxxxx</string></value></member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>status</name><value><i4>1</i4></value></member>
<member><name>error</name><value><string></string></value></member>
</struct></value>
</param>
</params>
</methodResponse>
■zoome.getDiaryInfo
▼説明
日記の情報を返します。
セッションを省略した場合は、「ネット全体に公開」となっている日記のみ返します。
セッションが指定され且つメンバー本人である場合は、非公開の日記を含めて返します。
(メイトに公開されている日記でも本人でなければ取得できません)
取得できなかった場合は空です。
▼引数
項目名 必須 デフォルト 説明
i4 zoomeid   zoomeの会員ID
i4 diaryid   日記ID
string session     セッション(zoome.loginの返り値)
▼返り値
項目名 説明
i4 diaryid 日記ID
string title タイトル
string body 本文
i4 themeid テーマID
array tagname タグ名(1〜6個)
string publictype 公開設定
[all]:全体に公開 [friend]:メイトに公開 [permit]:メイトを選んで公開 [private]:非公開
boolean iscomment コメントの許可 [1]:許可する [0]:許可しない
boolean isvote 投票の許可 [1]:許可する [0]:許可しない
boolean istagpaste プレイヤー貼り付けの許可 [1]:許可する [0]:許可しない
array imageurl1 画像1 [0]:small [1]:middle [2]:large
array imageurl2 画像2 [0]:small [1]:middle [2]:large
array imageurl3 画像3 [0]:small [1]:middle [2]:large
string externalplayer 外部プレイヤー
i4 cntview 閲覧数
string diaryurl 日記のURL(パーマリンク)
iso8601 registtime 投稿日時
my $method = 'zoome.getDiaryInfo';
my $apiarg = ({
    zoomeid => 31,
    diaryid => 37,
});
my $result = $server->call($method, $apiarg);
if ($result) {
    printf("diaryid: %d¥n",$result->{diaryid});
    printf("title: %s¥n",$result->{title});
    printf("body: %s¥n",$result->{body});
    printf("themeid: %d¥n",$result->{themeid});
    printf("tagname: %s¥n","@{$result->{tagname}}");
    printf("publictype: %s¥n",$result->{publictype});
    printf("iscomment: %d¥n",$result->{iscomment}->value);
    printf("isvote: %d¥n",$result->{isvote}->value);
    printf("istagpaste: %d¥n",$result->{istagpaste}->value);
    printf("imageurl1: %s¥n","@{$result->{imageurl1}}");
    printf("imageurl2: %s¥n","@{$result->{imageurl2}}");
    printf("imageurl3: %s¥n","@{$result->{imageurl3}}");
    printf("externalplayer: %s¥n", $result->{externalplayer});
    printf("cntview: %d¥n",$result->{cntview});
    printf("diaryurl: %s¥n",$result->{diaryurl});
    printf("registtime: %s¥n",$result->{registtime}->value);
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.getDiaryInfo</methodName>
<params>
<param><value><struct>
<member><name>zoomeid</name><value><i4>31</i4></value></member>
<member><name>diaryid</name><value><i4>37</i4></value></member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>imageurl1</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxxxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxxxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxxxx.jpg</string></value></data></array></value>
</member>
<member><name>iscomment</name><value><boolean>0</boolean></value>
</member>
<member><name>body</name><value><string>本文</string></value></member>
<member><name>diaryid</name><value><i4>37</i4></value></member>
<member><name>themeid</name><value><i4>1</i4></value></member>
<member><name>registtime</name><value><dateTime.iso8601>2007-08-01 13:10:05</dateTime.iso8601></value>
</member>
<member><name>cntview</name><value><i4>21</i4></value></member>
<member><name>publictype</name><value><string>all</string></value></member>
<member><name>externalplayer</name><value><string></string></value></member>
<member><name>imageurl2</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxxxx.jpg</string></value>
<value><string>http://img.zoome.jp/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>diaryurl</name><value><string>http://zoome.jp/info/diary/37</string></value>
</member>
<member><name>istagpaste</name><value><boolean>1</boolean></value>
</member>
<member><name>imageurl3</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jp</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>isvote</name><value><boolean>1</boolean></value>
</member>
<member><name>title</name><value><string>タイトル</string></value></member>
<member><name>tagname</name><value><array><data>
<value><string>タグ1</string></value><value><string>タグ2</string></value><value><string>タグ3</string></value><value><string>タグ4</string></value></data></array></value>
</member>
</struct></value>
</param>
</params>
</methodResponse>
■zoome.getDiaryList
▼説明
zoome会員が投稿した日記のリスト(構造体配列)を返します。
セッションを省略した場合は、「ネット全体に公開」となっている日記のみ返します。
セッションが指定され且つメンバー本人である場合は、非公開の日記を含めて返します。
(メイトに公開されている日記でも本人でなければ取得できません)
取得できなかった場合はcountがゼロとなります。
▼引数
項目名 必須 デフォルト 説明
i4 zoomeid   zoomeの会員ID
i4 offset   0 結果の取得開始位置
i4 length   10 結果の取得件数(最大100まで)
i4 order   0 並び(投稿日時) [0]:新しい順 [1]:古い順
string session     セッション(zoome.loginの返り値)
▼返り値
項目名 説明
i4 count 総件数
struct list リスト
    array   配列
        struct   構造体
            i4 diaryid 日記ID
            string title タイトル
            string body 本文
            i4 themeid テーマID
            array tagname タグ名(1〜6個)
            string publictype 公開設定
[all]:全体に公開 [friend]:メイトに公開 [permit]:メイトを選んで公開 [private]:非公開
            boolean iscomment コメントの許可 [1]:許可する [0]:許可しない
            boolean isvote 投票の許可 [1]:許可する [0]:許可しない
            boolean istagpaste プレイヤー貼り付けの許可 [1]:許可する [0]:許可しない
            array imageurl1 画像1 [0]:small [1]:middle [2]:large
            array imageurl2 画像2 [0]:small [1]:middle [2]:large
            array imageurl3 画像3 [0]:small [1]:middle [2]:large
            string externalplayer 外部プレイヤー
            i4 cntview 閲覧数
            string diaryurl 日記のURL(パーマリンク)
            iso8601 registtime 投稿日時
my $method = 'zoome.getDiaryList';
my $apiarg = ({
    zoomeid => 1,
    length => 3,
});
my $result = $server->call($method, $apiarg);
if ($result->{count}) {
    printf(qq{count: %d\n}, $result->{count});
    for my $row (@{$result->{list}}) {
        printf("diaryid: %d¥n", $row->{diaryid});
        printf("title: %s¥n", $row->{title});
        printf("body: %s¥n", $row->{body});
        printf("themeid: %d¥n", $row->{themeid});
        printf("tagname: %s¥n", "@{$row->{tagname}}");
        printf("publictype: %s¥n", $row->{publictype});
        printf("iscomment: %d¥n", $row->{iscomment}->value);
        printf("isvote: %d¥n", $row->{isvote}->value);
        printf("istagpaste: %d¥n", $row->{istagpaste}->value);
        printf("imageurl1: %s¥n", "@{$row->{imageurl1}}");
        printf("imageurl2: %s¥n", "@{$row->{imageurl2}}");
        printf("imageurl3: %s¥n", "@{$row->{imageurl3}}");
        printf("externalplayer: %s¥n", $row->{externalplayer});
        printf("cntview: %d¥n", $row->{cntview});
        printf("diaryurl: %s¥n", $row->{diaryurl});
        printf("registtime: %s¥n", $row->{registtime}->value);
    }
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.getDiaryList</methodName>
<params>
<param><value><struct>
<member><name>zoomeid</name><value><i4>1</i4></value></member>
<member><name>length</name><value><i4>3</i4></value></member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>count</name><value><i4>61</i4></value></member>
<member><name>list</name><value><array><data>
<value><struct>
<member><name>imageurl1</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>iscomment</name><value><boolean>1</boolean></value>
</member>
<member><name>body</name><value><string>本文1</string></value></member>
<member><name>diaryid</name><value><i4>81</i4></value></member>
<member><name>themeid</name><value><i4>3</i4></value></member>
<member><name>registtime</name><value><dateTime.iso8601>2007-10-18 19:01:52</dateTime.iso8601></value>
</member>
<member><name>cntview</name><value><i4>2</i4></value></member>
<member><name>publictype</name><value><string>all</string></value></member>
<member><name>externalplayer</name><value><string></string></value></member>
<member><name>imageurl2</name><value><array><data>
</data></array></value>
</member>
<member><name>diaryurl</name><value><string>http://zoome.jp/zoome/diary/81</string></value>
</member>
<member><name>istagpaste</name><value><boolean>1</boolean></value>
</member>
<member><name>imageurl3</name><value><array><data>
</data></array></value>
</member>
<member><name>isvote</name><value><boolean>1</boolean></value>
</member>
<member><name>title</name><value><string>件名1</string></value></member>
<member
2;<name>tagname</name><value><array><data> <value><string>日記</string></value>
<value><string>ペット</string></value><value><string>ワンコ
</string></value></data></array></value>
</member>
</struct></value>
<value><struct>
<member><name>imageurl1</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>iscomment</name><value><boolean>0</boolean></value>
</member>
<member><name>body</name><value><string>本文2</string></value></member>
<member><name>diaryid</name><value><i4>79</i4></value></member>
<member><name>themeid</name><value><i4>7</i4></value></member>
<member><name>registtime</name><value><dateTime.iso8601>2007-10-12 16:35:32</dateTime.iso8601></value>
</member>
<member><name>cntview</name><value><i4>21</i4></value></member>
<member><name>publictype</name><value><string>all</string></value></member>
<member><name>externalplayer</name><value><string></string></value></member>
<member><name>imageurl2</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>diaryurl</name><value><string>http://zoome.jp/zoome/diary/79</string></value>
</member>
<member><name>istagpaste</name><value><boolean>1</boolean></value>
</member>
<member><name>imageurl3</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>isvote</name><value><boolean>1</boolean></value>
</member>
<member><name>title</name><value><string>タイトル2</string></value></member>
<member><name>tagname</name><value><array><data>
<value><string>タグ1</string></value><value><string>タグ2</string></value><value><string>
タグ3</string></value><value><string>タグ4</string></value></data></array></value>
</member>
</struct></value>
<value><struct>
<member><name>imageurl1</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>iscomment</name><value><boolean>1</boolean></value>
</member>
<member><name>body</name><value><string>本文3</string></value></member>
<member><name>diaryid</name><value><i4>78</i4></value></member>
<member><name>themeid</name><value><i4>7</i4></value></member>
<member><name>registtime</name><value><dateTime.iso8601>2007-10-12 16:19:42</dateTime.iso8601></value>
</member>
<member><name>cntview</name><value><i4>8</i4></value></member>
<member><name>publictype</name><value><string>all</string></value></member>
<member><name>externalplayer</name><value><string></string></value></member>
<member><name>imageurl2</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>diaryurl</name><value><string>http://zoome.jp/zoome/diary/78</string></value>
</member>
<member><name>istagpaste</name><value><boolean>0</boolean></value>
</member>
<member><name>imageurl3</name><value><array><data>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/img1/xxx.jpg</string></value></data></array></value>
</member>
<member><name>isvote</name><value><boolean>1</boolean></value>
</member>
<member><name>title</name><value><string>タイトル3</string></value></member>
<member><name>tagname</name><value><array><data>
<value><string>タグ1</string></value><value><string>タグ2</string></value><value><string>
タグ3</string></value><value><string>タグ4</string></value></data></array></value>
</member>
</struct></value>
</data></array></value>
</member>
</struct></value>
</param>
</params>
</methodResponse>
■zoome.getMovieInfo
▼説明
動画の情報を返します。
セッションを省略した場合は、「ネット全体に公開」となっている動画のみ返します。
セッションが指定され且つメンバー本人である場合は、非公開の動画を含めて返します。
(メイトに公開されている動画でも本人でなければ取得できません)
取得できなかった場合は空です。
▼引数
項目名 必須 デフォルト 説明
i4 zoomeid   zoomeの会員ID
i4 diaryid   日記ID
string session     セッション(zoome.loginの返り値)
▼返り値
項目名 説明
i4 diaryid 日記ID
string status エンコード状況 [request]:エンコード待ち [encoding]:エンコード中
[encoded]:エンコード完了 [error]:エンコードエラー
string playtime 再生時間(mi:ss)
array thumburl サムネイル画像のurl(4枚)
i4 cntmyclip マイクリップ追加数
i4 cntvoteok 得票OK数
i4 cntvoteng 得票NG数
string pastehtml 貼り付けプレイヤーscriptタグ(貼り付けが許可されている場合のみ)
string pasteblog ブログパーツプレイヤーscriptタグ(貼り付けが許可されている場合のみ)
string pastehtml_object 貼り付けプレイヤーobjectタグ(貼り付けが許可されている場合のみ)
Modified 2009/02/19
string pasteblog_object ブログパーツプレイヤーobjectタグ(貼り付けが許可されている場合のみ)
Modified 2009/02/19
my $method = 'zoome.getMovieInfo';
my $apiarg = ({
    zoomeid => 1,
    diaryid => 14,
});
my $result = $server->call($method, $apiarg);
if ($result) {
    printf("diaryid: %d¥n", $result->{diaryid});
    printf("status: %s¥n", $result->{status});
    printf("playtime: %s¥n", $result->{playtime});
    printf("thumburl: %s¥n", "@{$result->{thumburl}}");
    printf("cntmyclip: %d¥n", $result->{cntmyclip});
    printf("cntvoteok: %d¥n", $result->{cntvoteok});
    printf("cntvoteng: %d¥n", $result->{cntvoteng});
    printf("pastehtml: %s¥n", $result->{pastehtml});
    printf("pasteblog: %s¥n", $result->{pasteblog});
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.getMovieInfo</methodName>
<params>
<param><value><struct>
<member><name>zoomeid</name><value><i4>1</i4></value></member>
<member><name>diaryid</name><value><i4>14</i4></value></member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>pastehtml</name><value><string>&lt;script type=&quot;text/javascript&quot;
src=&quot;http://www.zoome.jp/swfwrite?param=xxxxx&quot;&gt;&lt;/script&gt;</string></value></member>
<member><name>cntvoteng</name><value><i4>26</i4></value></member>
<member><name>status</name><value><string>encoded</string></value></member>
<member><name>pasteblog</name><value><string>&lt;script type=&quot;text/javascript&quot;
src=&quot;http://www.zoome.jp/swfblog?param=xxxxx&quot;&gt;&lt;/script&gt;</string></value></member>
<member><name>diaryid</name><value><i4>14</i4></value></member>
<member><name>cntmyclip</name><value><i4>3</i4></value></member>
<member><name>cntvoteok</name><value><i4>34</i4></value></member>
<member><name>playtime</name><value><string>00:30</string></value></member>
<member><name>thumburl</name><value><array><data>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value></data></array></value>
</member>
</struct></value>
</param>
</params>
</methodResponse>
■zoome.getMovieList
▼説明
zoome会員が投稿した動画のリスト(構造体配列)を返します。
セッションを省略した場合は、「ネット全体に公開」となっている動画のみ返します。
セッションが指定され且つメンバー本人である場合は、非公開の動画を含めて返します。
(メイトに公開されている動画でも本人でなければ取得できません)
取得できなかった場合はcountがゼロとなります。
▼引数
項目名 必須 デフォルト 説明
i4 zoomeid   zoomeの会員ID
i4 offset   0 結果の取得開始位置
i4 length   10 結果の取得件数(最大100まで)
i4 order   0 並び(投稿日時) [0]:新しい順 [1]:古い順
string session     セッション(zoome.loginの返り値)
▼返り値
項目名 説明
i4 count 総件数
struct list リスト
    array   配列
        struct   構造体
            i4 diaryid 日記ID
            string status エンコード状況 [request]:エンコード待ち [encoding]:エンコード中
[encoded]:エンコード完了 [error]:エンコードエラー
            string playtime 再生時間(mi:ss)
            array thumburl サムネイル画像のurl(4枚)
            i4 cntmyclip マイクリップ追加数
            i4 cntvoteok 得票OK数
            i4 cntvoteng 得票NG数
            string pastehtml 貼り付けプレイヤーscriptタグ(貼り付けが許可されている場合のみ)
            string pasteblog ブログパーツプレイヤーscriptタグ(貼り付けが許可されている場合のみ)
            string pastehtml_object 貼り付けプレイヤーobjectタグ(貼り付けが許可されている場合のみ)
Modified 2009/02/19
            string pasteblog_object ブログパーツプレイヤーobjectタグ(貼り付けが許可されている場合のみ)
Modified 2009/02/19
my $method = 'zoome.getMovieList';
my $apiarg = ({
    zoomeid => 1,
    length => 3,
});
my $result = $server->call($method, $apiarg);
if ($result->{count}) {
    printf("count: %d¥n", $result->{count});
    for my $row (@{$result->{list}}) {
        printf("diaryid: %d¥n", $row->{diaryid});
        printf("status: %s¥n", $row->{status});
        printf("playtime: %s¥n", $row->{playtime});
        printf("thumburl: %s¥n", "@{$row->{thumburl}}");
        printf("cntmyclip: %d¥n", $row->{cntmyclip});
        printf("cntvoteok: %d¥n", $row->{cntvoteok});
        printf("cntvoteng: %d¥n", $row->{cntvoteng});
        printf("pastehtml: %s¥n", $row->{pastehtml});
        printf("pasteblog: %s¥n", $row->{pasteblog});
    }
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.getMovieList</methodName>
<params>
<param><value><struct>
<member><name>zoomeid</name><value><i4>1</i4></value></member>
<member><name>length</name><value><i4>3</i4></value></member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>count</name><value><i4>30</i4></value></member>
<member><name>list</name><value><array><data>
<value><struct>
<member><name>pastehtml</name><value><string>&lt;script type=&quot;text/javascript&quot;
src=&quot;http://www.zoome.jp/swfwrite?param=xxx&quot;&gt;&lt;/script&gt;</string></value></member>
<member><name>cntvoteng</name><value><i4>0</i4></value></member>
<member><name>status</name><value><string>encoded</string></value></member>
<member><name>pasteblog</name><value><string>&lt;script type=&quot;text/javascript&quot;
src=&quot;http://www.zoome.jp/swfblog?param=xxx&quot;&gt;&lt;/script&gt;</string></value></member>
<member><name>diaryid</name><value><i4>81</i4></value></member>
<member><name>cntmyclip</name><value><i4>0</i4></value></member>
<member><name>cntvoteok</name><value><i4>0</i4></value></member>
<member><name>playtime</name><value><string>00:27</string></value></member>
<member><name>thumburl</name><value><array><data>
<value><string>http://mov.zoome.jp/mov1/xxx.jp</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value></data></array></value>
</member>
</struct></value>
<value><struct>
<member><name>pastehtml</name><value><string>&lt;script type=&quot;text/javascript&quot;
src=&quot;http://www.zoome.jp/swfwrite?param=xxx&quot;&gt;&lt;/script&gt;</string></value></member>
<member><name>cntvoteng</name><value><i4>5</i4></value></member>
<member><name>status</name><value><string>encoded</string></value></member>
<member><name>pasteblog</name><value><string>&lt;script type=&quot;text/javascript&quot;
src=&quot;http://www.zoome.jp/swfblog?param=xxx&quot;&gt;&lt;/script&gt;</string></value></member>
<member><name>diaryid</name><value><i4>79</i4></value></member>
<member><name>cntmyclip</name><value><i4>3</i4></value></member>
<member><name>cntvoteok</name><value><i4>10</i4></value></member>
<member><name>playtime</name><value><string>02:08</string></value></member>
<member><name>thumburl</name><value><array><data>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value></data></array></value>
</member>
</struct></value>
<value><struct>
<member><name>pastehtml</name><value><string></string></value></member>
<member><name>cntvoteng</name><value><i4>15</i4></value></member>
<member><name>status</name><value><string>encoded</string></value></member>
<member><name>pasteblog</name><value><string></string></value></member>
<member><name>diaryid</name><value><i4>78</i4></value></member>
<member><name>cntmyclip</name><value><i4>1</i4></value></member>
<member><name>cntvoteok</name><value><i4>0</i4></value></member>
<member><name>playtime</name><value><string>02:08</string></value></member>
<member><name>thumburl</name><value><array><data> <value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://mov.zoome.jp/mov1/xxx.jpg</string></value></data></array></value>
</member>
</struct></value>
</data></array></value>
</member>
</struct></value>
</param>
</params>
</methodResponse>
■zoome.tagSearch
▼説明
タグの検索を行い結果(構造体配列)を返します。
取得できなかった場合はcountがゼロとなります。
▼引数
項目名 必須 デフォルト 説明
string tagname   タグ名(スペース区切りで複数指定可)
i4 offset   0 結果の取得開始位置
i4 length   10 結果の取得件数(最大100まで)
▼返り値
項目名 説明
i4 count 総件数
struct list リスト
    array   配列
        struct   構造体
            i4 zoomeid zoomeの会員ID
            i4 diaryid 日記ID
            string title タイトル
            string body 本文(200文字まで)
            string diaryurl 日記のURL
            string mypageurl マイページのURL
            array thumburl サムネイル画像のurl(4枚)
            string nickname ニックネーム
            string playtime 再生時間(mi:ss)
            array tagname タグ名
            i4 cntview 閲覧数
            iso8601 registtime 投稿日時
my $method = 'zoome.tagSearch';
my $apiarg = ({
    tagname => '日記 ワンコ ペット',
    length => 3,
});
my $result = $server->call($method, $apiarg);
if ($result->{count}) {
    printf("count: %d¥n", $result->{count});
    for my $row (@{$result->{list}}) {
        printf("zoomeid: %d¥n", $row->{zoomeid});
        printf("diaryid: %d¥n", $row->{diaryid});
        printf("title: %s¥n", $row->{title});
        printf("body: %s¥n", $row->{body});
        printf("diaryurl: %s¥n", $row->{diaryurl});
        printf("mypageurl: %s¥n", $row->{mypageurl});
        printf("thumburl: %s¥n", "@{$row->{thumburl}}");
        printf("nickname: %s¥n", $row->{nickname});
        printf("playtime: %s¥n", $row->{playtime});
        printf("tagname: %s¥n", "@{$row->{tagname}}");
        printf("cntview: %d¥n", $row->{cntview});
        printf("registtime: %s¥n", $row->{registtime}->value);
    }
}
<?xml version="1.0"?>
<methodCall>
<methodName>zoome.tagSearch</methodName>
<params>
<param><value><struct>
<member><name>length</name><value><i4>3</i4></value></member>
<member><name>tagname</name><value><string>日記 ワンコ ペット</string></value></member>
</struct></value>
</param>
</params>
</methodCall>
<?xml version="1.0"?>
<methodResponse>
<params>
<param><value><struct>
<member><name>count</name><value><i4>974</i4></value></member>
<member><name>list</name><value><array><data>
<value><struct>
<member><name>zoomeid</name><value><i4>1</i4></value></member>
<member><name>registtime</name><value><dateTime.iso8601>2007-10-17 19:21:56</dateTime.iso8601></value>
</member>
<member><name>nickname</name><value><string>zoome-kun</string></value></member>
<member><name>cntview</name><value><i4>8</i4></value></member>
<member><name>mypageurl</name><value><string>http://zoome.jp/zoome/</string></value></member>
<member><name>diaryurl</name><value><string>http://zoome.jp/zoome/diary/10</string></value>
</member>
<member><name>body</name><value><string>本文1</string></value></member>
<member><name>diaryid</name><value><i4>10</i4></value></member>
<member><name>title</name><value><string>タイトル1</string></value></member>
<member><name>playtime</name><value><string>01:05</string></value></member>
<member><name>thumburl</name><value><array><data>
<value><string>http://img.zoome.jp/mov1/diary/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/mov1/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/mov1/diary/xxx.jpg</string></value></data></array></value>
</member>
<member><name>tagname</name><value><array><data>
<value><string>タグ1</string></value><value><string>タグ2</string></value><value><string>
タグ3</string></value><value><string>タグ4</string></value></data></array></value>
</member>
</struct></value>
<value><struct>
<member><name>zoomeid</name><value><i4>31</i4></value></member>
<member><name>registtime</name><value><dateTime.iso8601>2007-09-26 12:07:42</dateTime.iso8601></value>
</member>
<member><name>nickname</name><value><string>zoomeおしらせ</string></value></member>
<member><name>cntview</name><value><i4>33</i4></value></member>
<member><name>mypageurl</name><value><string>http://zoome.jp/info/</string></value></member>
<member><name>diaryurl</name><value><string>http://zoome.jp/info/diary/1</string></value></member>
<member><name>body</name><value><string>本文2</string></value></member>
<member><name>diaryid</name><value><i4>1</i4></value></member>
<member><name>title</name><value><string>タイトル2</string></value></member>
<member><name>playtime</name><value><string></string></value></member>
<member><name>thumburl</name><value><array><data>
<value><string>http://www.zoome.jp/img/nomovie3.jpg</string></value>
<value><string>http://www.zoome.jp/img/nomovie3.jpg</string></value>
<value><string>http://www.zoome.jp/img/nomovie3.jpg</string></value>
<value><string>http://www.zoome.jp/img/nomovie3.jpg</string></value></data></array></value>
</member>
<member><name>tagname</name><value><array><data>
<value><string>テスト</string></value><value><string>ペット</string></value><value><string>
タグ3</string></value><value><string>タグ4</string></value></data></array></value> </member>
</struct></value>
<value><struct>
<member><name>zoomeid</name><value><i4>1</i4></value></member>
<member><name>registtime</name><value><dateTime.iso8601>2007-09-20 11:05:16</dateTime.iso8601></value>
</member>
<member><name>nickname</name><value><string>zoome-kun</string></value></member>
<member><name>cntview</name><value><i4>73</i4></value></member>
<member><name>mypageurl</name><value><string>http://zoome.jp/zoome/</string></value></member>
<member><name>diaryurl</name><value><string>http://zoome.jp/zoome/diary/46</string></value>
</member>
<member><name>body</name><value><string>本文3</string></value></member>
<member><name>diaryid</name><value><i4>46</i4></value></member>
<member><name>title</name><value><string>タイトル3</string></value></member>
<member><name>playtime</name><value><string></string></value></member>
<member><name>thumburl</name><value><array><data>
<value><string>http://img.zoome.jp/mov1/diary/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/mov1/diary/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/mov1/diary/xxx.jpg</string></value>
<value><string>http://img.zoome.jp/mov1/diary/xxx.jpg</string></value></data></array></value>
</member>
<member><name>tagname</name><value><array><data>
<value><string>test</string></value><value><string>テスト</string></value><value><string>
日記</string></value><value><string>タグ4</string></value></data></array></value>
</member>
</struct></value>
</data></array></value>
</member>
</struct></value>
</param>
</params>
</methodResponse>