URL規則について

Introduction

mooom.jp でのURL規則を説明します。

username: ユーザー名
tag: タグ (urlencoded)
mid: ムービーID
LIST
Everyone's Movies ・・・ 全ての公開されたムービーリスト
http://mooom.jp/everyone/movies/
Everyone's Tags ・・・ 全ての公開されたタグリスト
http://mooom.jp/tags/
Everyone's Tag's Movies ・・・ タグ別公開ムービーリスト
http://mooom.jp/tags/{tag}/movies/
User's Movies ・・・ ユーザー別公開ムービーリスト
http://mooom.jp/{username}/movies/
User's Tags ・・・ ユーザー別公開タグリスト
http://mooom.jp/{username}/tags/
User's Tag's Movies ・・・ ユーザー別タグ別公開ムービーリスト
http://mooom.jp/{username}/tags/{tag}/movies/
User's Members ・・・ ユーザー別メンバーリスト
http://mooom.jp/{username}/members/
User's Member's Movies ・・・ ユーザー別メンバー別公開ムービーリスト
http://mooom.jp/{username}/members/movies/
User's Member's Tags ・・・ ユーザー別メンバー別公開タグリスト
http://mooom.jp/{username}/members/tags/
User's Member's Tag's Movies ・・・ ユーザー別メンバー別タグ別公開ムービーリスト
http://mooom.jp/{username}/members/tags/{tag}/movies/

Movie
Everyone's Movie
http://mooom.jp/everyone/movies/movie/{mid}/
User's Movie
http://mooom.jp/{username}/movies/movie/{mid}/
Everyone's Tag's Movie
http://mooom.jp/tags/{tag}/movies/movie/{mid}/
User's Tag's Movie
http://mooom.jp/{username}/tags/{tag}/movies/movie/{mid}/

RSS (RSS2.0 width enclosure)について

Introduction

ムービーリストのRSSです。
各URLの末尾に"rss20"を付加してリクエストします。
offset値、limit値をクエリーに付加することで、取得件数を変更できます。

Request

username: ユーザー名
tag: タグ (urlencoded)
Everyone's Movies RSS
http://mooom.jp/everyone/movies/rss20
Everyone's Tags Movies RSS
http://mooom.jp/tags/{tag}/movies/rss20
User's Movies RSS
http://mooom.jp/{username}/movies/rss20
User's Tags's Movies RSS
http://mooom.jp/{username}/tags/{tag}/movies/rss20
User's Member's Movies RSS
http://mooom.jp/{username}/members/movies/rss20
User's Member's Tag's MoviesRSS
http://mooom.jp/{username}/members/tags/{tag}/movies/rss20
Method
GET/POST
Param
offset: 取得開始位置
limit: 取得件数

Sample

Everyone's Movies RSS
http://mooom.jp/everyone/movies/rss20?offset=0&limit=50
Everyone's Tags Movies RSS / Tag:ねこ
http://mooom.jp/tags/%E3%81%AD%E3%81%93/movies/rss20?offset=0&limit=50

FLV・iPod/PSP用データの取得

Introduction

Flash用データ(FLV)と、iPod/PSP 用のMP4 データの取得方法を説明します。
ムービーのURLの末尾に、対応した拡張子を付加してリクエストすることでデータを取得できます。

Sample

mid: ムービーID
FLV
http://mooom.jp/everyone/movies/movie/{mid}/.flv
MP4 (2006/07/30 以降アップロードされたデータのみ対応 )
http://mooom.jp/everyone/movies/movie/{mid}/.mp4
MOV (2006/07/30 以前にアップロードされたデータのみ対応 )
http://mooom.jp/everyone/movies/movie/{mid}/.mov
JPG
http://mooom.jp/everyone/movies/movie/{mid}/.jpg

ムービー・サムネールの取得

Introduction

ムービーのサムネール画像(JPG)の取得方法を説明します。
ムービーのサムネールは表示サイズごとにいくつか用意されています。

Sample

mid: ムービーID
thumbA: 80x60 縦横比率固定
http://mooom.jp/images/thumbA/{mid}/

thumbB: オリジナルサイズ
http://mooom.jp/images/thumbB/{mid}/

thumbC: 74x57 縦横比率固定
http://mooom.jp/images/thumbC/{mid}/

thumbD: 40x30 縦横比率固定
http://mooom.jp/images/thumbD/{mid}/

thumbE: 160x120 縦横比率固定
http://mooom.jp/images/thumbE/{mid}/

ユーザー・アイコンの取得

Introduction

ユーザー・アイコンのサムネール画像(JPG)の取得方法を説明します。
ユーザー・アイコンのサムネールは表示サイズごとにいくつか用意されています。

Sample

name: ユーザー名
iconA: 120x120
http://mooom.jp/images/iconA/{name}/

iconB: 45x45
http://mooom.jp/images/iconB/{name}/

iconC: 30x30
http://mooom.jp/images/iconC/{name}/

iconD: 60x60
http://mooom.jp/images/iconD/{name}/

API

Introduction

REST形式のAPIについて説明します。

Basic Response

応答の基本XML仕様です。
<?xml verion="1.0" encoding="UTF-8" ?>
<response>
	<request>SUCCESS or ERROR</request>
	<status>STATUS CODE</status>
	<detail>
	.....
	</detail>
</response>

get_MovieList

各種ムービーリスト取得リクエストです。

Request

/api/get_MovieList?lt={lt}&name={name}&tag={urlencode(tag)}&offset={offset}
&limit={limit}

Param

lt [必須]
 - EveryonesMovieList
 - UsersMovieList
 - TagsMovieList
 - MembersMovieList
 - MembersTagsMovieList
 - UsersTagsMovieList
 - RandomMovieList
 - TodayPlayRankMovieList
 - AllPlayRankMovieList
name: ユーザー名
offset:	取得位置
limit:	取得件数

Response

<total>{total}</total>
<cnt>{cnt}</cnt>
<movies>
	<movie mid="{mid}">
		<title>{title}</title>
		<description>{description}</description>
		<name>{username}</name>
		<timestamp>{timestamp}</timestamp>
		<plays>{plays}</plays>
		<comments>{comments}</comments>
		<favorites>{favorites}</favorites>
		<tags>
			<tag tag_id="{tag_id}">{tag}</tag>
			.....
		</tags>
		<encode status="{encoding or encoded}" />
		<geo lat="{latitude}" lng="longitude" />
	</movie>
	.....
</movies>

get_CommentList

ムービーのコメント取得リクエストです。

Request

/api/get_CommentList?mid={mid}&offset={offset}&limit={limit}

Param

mid: ムービーID [必須]
offset:	取得位置
limit:	取得件数

Response

<total>{total}</total>
<cnt>{cnt}</cnt>
<comments>
	<comment cid="{cid}">
		<name>{username}</name>
		<description>{description}</description>
		<timestamp>{timestamp}</timestamp>
	</comment>
	.....
</comments>

get_TagList

タグリスト取得リクエストです。

Request

/api/get_TagList?lt={lt}&name={name}&mid={mid}&offset={offset}&limit={limit}

Param

lt [必須]
 - EveryonesTagList
 - UsersMovieList
 - MembersTagList
 - MoviesTagList
mid: ムービーID
name: ユーザー名
offset:	取得位置
limit:	取得件数

Response

<total>{total}</total>
<cnt>{cnt}</cnt>
<tags>
	<tag tag_id="{tag_id}" movies="{num}">{tag}</tag>
	.....
</tags>

search_Movies

ムービーリスト検索リクエストです。

Request

/api/search_Movies?section=title or tag}&keyword={urlencode(keyword)}&offset={offset}
&limit={limit}

Param

section: title or tag
keyword: 検索文字列
offset:	取得位置
limit:	取得件数

Response

get_MovieList と同じ

get_PointList

地図情報を持つムービーのポイントリストです。

Request

/api/get_PointList?lt={lt}&name={name}&tag={urlencode(tag)}&offset={offset}
&limit={limit}

Param

lt [必須]
 - EveryonesMoviesPointList
 - UsersMoviesPointList
 - TagsMoviesPointList
name: ユーザー名
offset:	取得位置
limit:	取得件数

Response

get_MovieList と同じ

Sample Applications

Google Gadget

Google パーソナルに mooom.jp のビデオを表示させるGadget。
コンテンツを追加する
http://mooom.jp/api/googleGadget.xml