root/twttmixi/trunk/lib/WWW/Mixi/Mixi.pod @ 1

=encoding utf8

=head1 NAME

WWW::Mixi - Mixiアクセス甚のLWP::UserAgentモゞュヌル

=head1 SYNOPSIS

  use WWW::Mixi;
  $mixi = WWW::Mixi->new('me@foo.com', 'password', '-log' => 1, '-logcode' => 'sjis');
  $mixi->login;
  my $res = $mixi->get('home.pl');
  print $res->content;

=head1 DESCRIPTION

Mixiにアクセスするためのモゞュヌルです。

LWP::RobotUAのサブクラスになっおおり、LWP::UserAgentおよびLWP::RobotUAず同じように䜿うこずができたす。
WWW::MixiにはLWP::UserAgentより䟿利な点が3぀ありたす。

たず、WWW::Mixiではログむン関連の䜜業をすべおloginメ゜ッドで枈たせるこずができたす。
loginメ゜ッドは、Cookieが無効になっおいれば有効にし、オブゞェクト生成時に受け取ったメヌルアドレスずパスワヌドをloginペヌゞに送出し、レスポンスを解析しおセッションIDずリフレッシュå
ˆã®URLを取埗したす。
ログむン状況は、is_login_required、is_logined、session、refreshなどのメ゜ッドで確認できたす。

それから、いく぀かの䟿利なメ゜ッドが甚意されおいたす。
倧別すれば2系統で、䞀぀は絶察URLを取埗するためのabsolute_urlやabsolute_linked_urlです。前è€
はmixiのホヌムペヌゞたたは指定されたURLをベヌスずした絶察URLを、埌è€
は最埌にgetたたはpostで取埗したペヌゞをベヌスずしたURLを返したす。
もう䞀぀は、mixiのコンテンツを解析するためのメ゜ッドです。メむンメニュヌ解析甚のparse_main_menu、ツヌルバヌ解析甚のparse_tool_bar、お知らせ解析甚のparse_informationメ゜ッドなど倚数の解析メ゜ッドず、URLの取埗ず解析をたずめお行うget_main_menuなどのメ゜ッドがありたす。

たた、実際にはLWP::RobotUAのサブクラスなので、ロボットずしおの劥圓な動䜜を行おうずしたす。
äž€ã€ã«ã¯ã€ãŸãŸã€ã‚µãƒŒãƒãƒŒã«é«˜è² è·ã‚’ã‹ã‘ãªã„ã‚ˆã†delayが1秒に蚭定されおおり、1秒間に1回以䞊のリク゚ストは凊理しないようになっおいたす。
なお、tobot.txtのチェックはしおいたせん。
いく぀かの経緯から、WWW::Mixiではrobot.txtをチェックしないこずをMixi運営事務局から提案されたこずによりたす。

=head1 METHODS

WWW::MixiはLWP::RobotUAのサブクラスずしお実è£
されおいたすので、LWP::RobotUAずその芪クラスであるLWP::UserAgentのメ゜ッドを匕き継いでいたす。
これらの䜿い方に぀いおは、各クラスのドキュメントをご芧ください。

=head2 Constructor

WWW::Mixiのコンストラクタです。

=head3 $mixi = WWW::Mixi->new($email [, $password] [, '-log' => $log] [, '-logcode' => $kanji_code] [, '-abort' => \&aborting_method] [, '-rewrite' => \&rewriting_method] )

WWW::Mixiオブゞェクトを䜜成するコンストラクタです。

最初に匕数は、mixiにログむンするためのメヌルアドレスで、å¿
é ˆã§ã™ã€‚
二番目の匕数は、mixiにログむンするためのパスワヌドです。
その他のオプションは、省略可胜です。

=over 4

=item '-log'

ログの出力レベルを指定したす。
0を指定した時はたったくログは出力されず、1を指定したずきはタグなしおよび"[error]"タグのログだけを出力し、5以䞊であれば"[usage]"、"[warn]"、"[info]"、そしおデヌタダンプなども出力されたす。
この出力自䜓は、å†
郚メ゜ッドのcallback_logメ゜ッドで行われおいたす。

出力レベルを指定する代わりに、独自のログ出力メ゜ッドを指定するこずもできたす。
$logにログ出力メ゜ッドぞのリファレンスを指定しおください。
ログが発生した際、ログ出力メ゜ッドには、WWW::Mixiオブゞェクトおよびログ文字列が匕数ずしお枡されたす。

=item '-logcode'

ログを出力する際の挢字コヌドを指定したす。
'euc'デフォルト以倖の文字コヌドを指定するずきは、Jcodeモゞュヌルがå¿
芁になりたす。

なお、-logオプションで独自のログ出力メ゜ッドを指定しおいるずきには、この挢字コヌド指定の有効性はそのメ゜ッド次第です。

=item '-abort'

゚ラヌ時の終了凊理を行うためのメ゜ッドを指定したす。
未指定時は、WWW::Mixiの持぀callback_abortメ゜ッドが䜿われたす。

=item '-rewrite'

HTMLをテキストに曞き盎すためのメ゜ッドを指定したす。
未指定時は、WWW::Mixiの持぀callback_rewriteメ゜ッドが䜿われたす。

=back

このメ゜ッドはLWP::RobotUAを介しおLWP::UserAgentから継承したnewメ゜ッドを䞊曞きしおいたす。

=head2 Login and Login information

mixiにログむンするためのメ゜ッドず、珟圚のログむン状況、セッションIDなどの関連æƒ
å ±ã‚’å–åŸ—ã™ã‚‹ãŸã‚ã®ãƒ¡ã‚œãƒƒãƒ‰çŸ€ã§ã™ã€‚

=head3 $response = $mixi->login( [$password] );

mixiにログむンしたす。
å¿
芁であれば、Cookieの有効化などが行われたす。

ログむン時のパスワヌドは、$passwordが指定されればこの倀を䜿甚したす。
未指定時は、コンストラクタで指定されたパスワヌドを䜿甚したす。
ã‚³ãƒ³ã‚¹ãƒˆãƒ©ã‚¯ã‚¿ã§ã‚‚ãƒ‘ã‚¹ãƒ¯ãƒŒãƒ‰ã‚’æŒ‡å®šã—ãŠã„ãªã„å Žåˆã€ã“ã®ãƒ¡ã‚œãƒƒãƒ‰ã¯äœ•ã®ã‚¢ã‚¯ã‚·ãƒ§ãƒ³ã‚‚è¡Œã‚ãšã€undefを返したす。

返り倀はログむン時のHTTP::Responseオブゞェクトです。
ログむン倱敗時のレスポンスコヌドは401になりたすので、以䞋のような゚ラヌハンドリングが可胜です。

 $mixi->login->is_sucess or die 'Login failed';

次のようにすれば、ログむン倱敗時に理由を確認しやすくなるでしょう。

 $res = $mixi->login;
 $res->is_success or die $res->status_line;

=head3 $result = $mixi->is_logined

ログむン枈みであれば1、未ログむンであれば0を返したす。

=head3 $result = $mixi->is_login_required( [$response] )

最埌にgetたたはpostで取埗したペヌゞデヌタを解析しお、ログむンフォヌムが衚瀺されおいないか確認したす。
ペヌゞの取埗が成功しおいお、ログむンフォヌムが衚瀺されおいないずきには0を返したす。
ログむンフォヌムが衚瀺されおいるずきなどには、゚ラヌメッセヌゞを返したす。

$responseを指定したずきには、最埌に取埗したペヌゞの倉わりに$responseを解析したす。
$responseにはHTTP::Responseオブゞェクトget、post、request、simple_requestメ゜ッドなどの返り倀がそうですを指定しおください。

=head3 $session = $mixi->session( [$session] );

珟圚のセッションIDを返したす。
ログむン前など、セッションIDを取埗できおいない時にはundefが返りたす。

$sessionを指定したずきには、セッションIDを指定した倀で眮き換えたす。

=head3 $stamp = $mixi->stamp( [$stamp] );

珟圚のセッションスタンプを返したす。
ログむン前など、セッションスタンプを取埗できおいない時にはundefが返りたす。

$stampを指定したずきには、セッションスタンプを指定した倀で眮き換えたす。

=head3 $url = $mixi->refresh

ログむン時に取埗したリフレッシュURLを返したす。

=head2 Fetch URL

ペヌゞを取埗するためのメ゜ッドです。
ãªãŠã€ãƒ­ã‚°ã‚€ãƒ³å‰ã«å®Ÿè¡Œã—ãŸå Žåˆã¯ã€è©²åœ“ãƒšãƒŒã‚žã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã¯å–åŸ—ã§ããšã€ãƒ¬ã‚¹ãƒãƒ³ã‚¹ã‚³ãƒŒãƒ‰ã¯401になりたす。

=head3 $response = $mixi->request($request, $arg [, $size]) )

このメ゜ッドはLWP::UserAgentのrequestメ゜ッドずほが同じ動䜜をしたす。
䜿い方に぀いおは、LWP::UserAgentのドキュメントを参ç
§ã—おください。

なお、「デヌタはありたせん。」が返された時のレスポンスコヌドは400、芁ログむン時のレスポンスコヌドはloginメ゜ッド同様401です。
たた、このメ゜ッドはLWP::RobotUAのrequestメ゜ッドを実行しおいたす。
䟋えばRobot exclutionを守る、指定されたアクセス間隔をあけるなどずいった点は同様の動䜜をしたす。

=head3 $response = $mixi->get($url)

GETメ゜ッドで指定されたURLを取埗したす。
URLの代わりに'login'、'show_logs'などの'.pl'を省いたファむル名を指定しおも構いたせん。

返り倀はHTTP::Responseオブゞェクトで、これはLWP::UserAgentモゞュヌルのrequestメ゜ッドず同じです。

=head3 $response = $mixi->post($url ['field' => value, ...])

POSTメ゜ッドで指定されたURLを取埗したす。
URLの代わりに'login'、'show_logs'などの'.pl'を省いたファむル名を指定しおも構いたせん。

POST時のフィヌルドの倀は、'name' => 'Mr. Mixi', 'Age' => '3years'のように、フィヌルド名ず倀の察で指定しおください。この察はいく぀指定しおも構いたせん。
フィヌルド倀にはファむルを指定するこずもできたす。この時は、'pic1' => ['./picture.jpg']のように、ファむルパスだけをé
åˆ—リファレンスで枡しおください。
なお、POSTデヌタはHTTP::Request::CommonモゞュヌルのPOSTメ゜ッドで凊理されたす。ファむル指定の詳现などに぀いおはこちらでご確認ください。

返り倀はHTTP::Responseオブゞェクトで、これはLWP::UserAgentモゞュヌルのrequestメ゜ッドず同じです。

=head3 $response = $mixi->response()

最埌に取埗されたレスポンスを返したす。
返り倀はHTTP::Responseオブゞェクトで、これはLWP::UserAgentモゞュヌルのrequestメ゜ッドの返り倀ず同じです。

=head2 Parse response

取埗枈みのペヌゞを解析したす。

解析系のメ゜ッドはいずれも、匕数$responseを指定したずきには$responseを、未指定時は最埌にgetたたはpostメ゜ッドで取埗したデヌタを解析したす。
$responseにはHTTP::Responseオブゞェクトget、post、request、simple_requestメ゜ッドなどの返り倀がそうですを指定しおください。

=head3 @items = $mixi->parse_main_menu( [$response] );

メむンメニュヌ「mixi」のロゎず䞀䜓になっおいる郚分のメニュヌのé 
目を取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'ホヌム',
        'link' => 'http://mixi.jp/home.pl'
 }

=head3 @items = $mixi->parse_banner( [$response] );

バナヌメむンメニュヌに埋め蟌たれおいるものを取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => '求人サむトFind Job !',
        'link' => 'http://mixi.jp/banner.pl?id=x'
        'image' => 'http://banner.host.domain/image.gif'
 }

mixiの利甚芏玄の「2.犁止事é 
」第二条には「mixi の運営たたはネットワヌク・システムを劚害する行為」が含たれおおり、バナヌによる利益を埗るこずはmixiの運営にå¿
芁なこずだず思われたす。
WWW::Mixiモゞュヌルを䜿甚する際は、䞊蚘を良く考æ
®ã—た䞊で、バナヌを適切に扱うこずを掚奚したす。

=head3 @items = $mixi->parse_tool_bar( [$response] );

ツヌルバヌのé 
目を取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'トップペヌゞ',
        'link' => 'http://mixi.jp/home.pl'
 }

=head3 @items = $mixi->parse_information( [$response] );

お知らせのé 
目を取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'あなたの友人を mixi に招åŸ
しよう',
        'link' => 'http://mixi.jp/invite.pl',
        'description\' => '友人を招åŸ
'
        'style' => {
                'color' => 'red',
                'font-weight' => 'bold'
        },
 }

=head3 @items = $mixi->parse_home_new_album( [$response] );

ホヌム(home.pl)のマむミクシィ最新アルバムを取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'link' => 'http://mixi.jp/view_album.pl?id=xxxxx',
        'subject' => '10月1日のアルバム',
        'time' => '10/01',
        'name' => 'walrus'
 },

=head3 @items = $mixi->parse_home_new_bbs( [$response] );

ホヌム(home.pl)のコミュニティ最新曞き蟌みを取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'link' => 'http://mixi.jp/view_bbs.pl?id=xxxxxx',
        'subject' => 'はじめたしお (59)',
        'time' => '09/11',
        'name' => 'WWW::Mixi'
 }

=head3 @items = $mixi->parse_home_new_comment( [$response] );

ホヌム(home.pl)の日蚘コメント蚘å
¥å±¥æ­Žã‚’取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx&owner_id=xxxx',
        'name' => '塚本牧生',
        'time' => '08/18'
 }

=head3 @items = $mixi->parse_home_new_friend_diary( [$response] );

ホヌム(home.pl)のマむミクシィ最新日蚘を取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx&owner_id=xxxx',
        'name' => '塚本牧生',
        'time' => '08/18'
 }

=head3 @items = $mixi->parse_home_new_review( [$response] );

ホヌム(home.pl)のマむミクシィ最新レビュヌを取埗したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'link' => 'http://mixi.jp/list_review.pl?id=xxxxx&item_id=xxxxxxx',
        'subject' => 'ミクシィHacks (5)',
        'time' => '05/02',
        'name' => 'walrus'
 }

=head3 @items = $mixi->parse_ajax_new_diary( [$response] );

マむミクシィの最新日蚘Ajax版ajax_new_diary.plを解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx&woner_id=xxxxxx',
        'time' => '2004/08/18'
 }

=head3 $id = $mixi->parse_community_id( [$response] );

コミュニティview_community.plを解析し、このコミュニティのIDを返したす。
IDを取埗できなかった時の返り倀は0です。

このメ゜ッドは他の倚くの解析系メ゜ッドず違い、ハッシュリファレンスのé
åˆ—ではなくただの文字列スカラ倀を返すこずに泚意しおください。

=head3 @items = $mixi->parse_edit_member( [$response] );

メンバヌ管理edit_member.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'walrus',
        'link' => 'http://mixi.jp/show_friend.pl?id=xxxxx',
        'delete_member' => {
                'link' => 'http://mixi.jp/delete_member.pl?comm_id=xxxxx&member_id=xxxxxxx',
                'subject' => 'メンバヌから倖す'
        },
        'transfer_admin' => {
                'link' => 'http://mixi.jp/transfer_admin.pl?comm_id=xxxxx&member_id=xxxxxxx',
                'subject' => '管理暩を枡す'
        }
 }

=head3 @items = $mixi->parse_edit_member_pages( [$response] );

メンバヌ管理edit_member.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => '1',
        'link' => 'http://mixi.jp/edit_member.pl?id=236233',
        'current' => '1'
 }

'current'は珟圚のペヌゞに察しおは1、それ以倖のペヌゞに察しおは0です。

=head3 @items = $mixi->parse_list_bbs( [$response] );

メンバヌ管理のペヌゞ䞀芧edit_member.plのペヌゞ䞀芧郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => '0.33版å
¬é–‹ã€‚',
        'link' => 'http://mixi.jp/view_bbs.pl?id=1492858',
        'time' => '08/16 13:38',
        'description' => '0.33版をå
¬é–‹ã—たした。CPANにもアップロヌド枈みで、今日、明日䞭にはCPANモゞュヌルでのむンストヌルが可胜になるず思いたす。'
        'count' => '3',
        'images' => [
                {
                        'thumb_link' => 'http://img1.mixi.jp/photo/bbs/xx/xx/xxxxxxx_xxs.jpg',
                        'link' => 'show_picture.pl?img_src=http://img1.mixi.jp/photo/bbs/xx/xx/xxxxxxx_xx.jpg'}
                },
        ],
 }

countはコメント数です。

=head3 $item = $mixi->parse_list_bbs_next( [$response] );

トピック䞀芧list_bbs.plのメむン郚の「次を衚瀺」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ¬¡ã‚’è¡šç€ºã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '次を衚瀺',
        'link' => 'http://mixi.jp/list_bbs.pl?page=2&id=43735',
 }

=head3 $item = $mixi->parse_list_bbs_previous( [$response] );

トピック䞀芧list_bbs.plのメむン郚の「前を衚瀺」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œå‰ã‚’è¡šç€ºã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '前を衚瀺',
        'link' => 'http://mixi.jp/list_bbs.pl?page=1&id=43735',
 }

=head3 @items = $mixi->parse_list_bookmark( [$response] );

お気にå
¥ã‚ŠïŒˆlist_bookmark.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'walrus',
        'gender' => undef,
        'description' => 'PerlマニアでPDAマニアでザりルスナヌザヌ。メむンサむトの日蚘はこちらです。...',
        'image' => 'http://img.mixi.jp/photo/member/xx/xx/xxxx.jpg',
        'link' => 'http://mixi.jp/show_friend.pl?id=xxxxxx',
        'time' => '2004/08/18 13:18'
 }

=head3 @items = $mixi->parse_list_comment( [$response] );

最近のコメントlist_comment.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18 13:18'
 }

=head3 @items = $mixi->parse_list_community( [$response] );

コミュニティ䞀芧list_community.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'WWW::Mixiモゞュヌル',
        'link' => 'http://mixi.jp/view_community.pl?id=xxxx',
        'image' => 'http://img.mixi.jp/photo/comm/xx/xx/xxxx_xxs.jpg',
        'count' => '20'
 }

=head3 $item = $mixi->parse_list_community_next( [$response] );

コミュニティ䞀芧list_community.plのメむン郚の「次のペヌゞ」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ¬¡ã®ãƒšãƒŒã‚žã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '次のxx件',
        'link' => 'http://mixi.jp/list_community.pl?page=x',
 }

=head3 $item = $mixi->parse_list_community_previous( [$response] );

コミュニティ䞀芧list_community.plのメむン郚の「前のペヌゞ」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œå‰ã®ãƒšãƒŒã‚žã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '前の50件',
        'link' => 'http://mixi.jp/list_community.pl?page=x',
 }

=head3 @items = $mixi->parse_list_diary( [$response] );

日蚘list_diary.plのメむン郚分甚の解析メ゜ッドです。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。
imagesの䞭身はサムネむルず本䜓画像のURLをハッシュリファレンスにしたもののé
åˆ—になりたす。

 {
        'subject'     => 'こんにちは。',
        'link'        => 'http://mixi.jp/view_diary.pl?id=xxxxxx',
        'description' => 'æœ¬æ–‡ã®å†’é ­...',
        'time'        => '08/18 13:18'
        'count'       => 'コメント件数',
        'images'      => [
                {
                        'link'        => 'http://img.mixi.jp/photo/diary/xx/xx/xxxxxxxxx_xxx.jpg',
                        'thumb_link'  => 'http://img.mixi.jp/photo/diary/xx/xx/xxxxxxxxx_xxxs.jpg'
                }
        ]
 }

=head3 $item = $mixi->parse_list_diary_capacity( [$response] );

日蚘list_diary.plのメむン郚の「日蚘の䜿甚状況」を解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ—¥èš˜ã®äœ¿ç”šçŠ¶æ³ã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'max' => '100.0',
        'used' => '2.2',
 }

=head3 $item = $mixi->parse_list_diary_next( [$response] );

日蚘list_diary.plのメむン郚の「次のxx件」ぞのリンクを解析したす。
返り倀は、「次のxxä»¶ã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '次のxx件',
        'link' => 'http://mixi.jp/list_diary.pl?page=x',
 }

=head3 $item = $mixi->parse_list_diary_previous( [$response] );

日蚘list_diary.plのメむン郚の「前のxx件」ぞのリンクを解析したす。
返り倀は、「前のxxä»¶ã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '前のxx件',
        'link' => 'http://mixi.jp/list_diary.pl?page=x',
 }

=head3 @items = $mixi->parse_list_diary_monthly_menu( [$response] );

日蚘list_diary.plの各月のむンデックスぞのリンクを解析したす。
返り倀は、月ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'link' => 'http://mixi.jp/list_diary.pl?year=2005&month=7',
        'month' => '7',
        'year' => '2005'
 },

=head3 @items = $mixi->parse_list_friend( [$response] );

友人・知人䞀芧list_friend.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'walrusさん',
        'link' => 'http://mixi.jp/show_friend.pl?id=xxxxx',
        'image' => 'http://img.mixi.jp/photo/member/xx/xx/xxxxx_xxxxxxxxxx.jpg',
        'background' => 'http://img.mixi.jp/img/bg_xxx.gif',
        'id' => 'xxxxx',
        'count' => 'xxx'
        'status' => '1時間以å†
',
 }

=head3 $item = $mixi->parse_list_friend_next( [$response] );

友人・知人䞀芧list_friend.plのメむン郚の「次のペヌゞ」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ¬¡ã®ãƒšãƒŒã‚žã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '次のxx件',
        'link' => 'http://mixi.jp/list_friend.pl?page=x',
 }

=head3 $item = $mixi->parse_list_friend_previous( [$response] );

友人・知人䞀芧list_friend.plのメむン郚の「前のペヌゞ」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œå‰ã®ãƒšãƒŒã‚žã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '前の50件',
        'link' => 'http://mixi.jp/list_friend.pl?page=x',
 }

=head3 @items = $mixi->parse_list_member( [$response] );

メンバヌ䞀芧list_member.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'walrusさん',
        'link' => 'http://mixi.jp/show_friend.pl?id=xxxxxx',
        'id' => 'xxxxx',
        'count' => 'xx',
        'image' => 'http://img.mixi.jp/photo/member/xx/xx/xxxxxx_xxxxxxxxxxs.jpg'
        'background' => 'http://img.mixi.jp/img/bg_line.gif',
 }

=head3 $item = $mixi->parse_list_member_next( [$response] );

メンバヌ䞀芧list_member.plのメむン郚の「次を衚瀺」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ¬¡ã‚’è¡šç€ºã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '次を衚瀺',
        'link' => 'http://mixi.jp/list_member.pl?page=2&id=xxxxx',
 }

=head3 $item = $mixi->parse_list_member_previous( [$response] );

メンバヌ䞀芧list_member.plのメむン郚の「前を衚瀺」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œå‰ã‚’è¡šç€ºã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '前を衚瀺',
        'link' => 'http://mixi.jp/list_member.pl?page=1&id=xxxxx',
 }

=head3 @items = $mixi->parse_list_message( [$response] );

最近の受信メッセヌゞlist_message.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。
statusはnew(新着)、opened(既読)、replied(返信枈み)、unknown(䞍明)になりたす。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_message.pl?id=xxxxxx&box=xxxxx',
        'name' => '塚本牧生',
        'time' => '08/18',
        'status' => 'replied',
        'emvelope' => 'http://mixi.jp/img/mail5.gif'
 }

=head3 @items = $mixi->parse_list_outbox( [$response] );

最近の送信メッセヌゞlist_message.pl?box=outboxのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_message.pl?id=xxxxxx&box=xxxxx',
        'name' => '塚本牧生',
        'time' => '08/18',
 }

=head3 @items = $mixi->parse_list_request( [$response] );

承認åŸ
ち䞀芧list_request.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'walrus',
        'gender' => undef,
        'link' => 'http://mixi.jp/show_friend.pl?id=xxxxx',
        'image' => 'http://img.mixi.jp/photo/member/xx/xx/xxxxx_xxxxxxxxxs.jpg'
        'time' => '2005/09/24 14:45',
        'description' => 'WWW::Mixi䜜è€
です。ここにはプロフィヌルの説明文がå
¥ã‚ŠãŸã™ã€‚',
        'message' => 'å
ˆæ—¥ã¯ãƒ¡ãƒŒãƒ«ã§é¢ç™œã„話をありがずうごさいたした。
        æ”¹ã‚ãŠãƒžã‚€ãƒŸã‚¯ã‚·ã‚£ã«åŠ ãˆã•ã›ãŠã„ãŸã ããŸã„ãšæ€ã£ãŠãŸã™ã€‚
        よろしくです。',
        'button' => [
                {
                        'link' => 'http://mixi.jp/accept_request.pl?id=xxxxx&post_key=xxxxxxxxxxxxxxx',
                        'title' => '承認',
                        'image' => 'http://img.mixi.jp/img/ybtn.gif'
                },
                {
                        'link' => 'http://mixi.jp/reject_request.pl?id=xxxxx&post_key=xxxxxxxxxxxxxxx',
                        'title' => '拒吊',
                        'image' => 'http://img.mixi.jp/img/nbtn.gif'
                }
        ],
 }

=head3 @items = $mixi->parse_new_album( [$response] );

マむミクシィ最新アルバムnew_album.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => '塚本家の人ã€
',
        'link' => 'http://mixi.jp/view_album.pl?id=xxxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18 13:18'
 }

=head3 @items = $mixi->parse_new_bbs( [$response] );

コミュニティ最新曞き蟌みnew_bbs.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'link' => 'http://mixi.jp/view_bbs.pl?id=xxxxxx',
        'subject' => 'はじめたしお (59)',
        'time' => '2005/09/11 16:49',
        'name' => 'WWW::Mixi'
 }

=head3 $item = $mixi->parse_new_bbs_next( [$response] );

コミュニティ最新曞き蟌みnew_bbs.plのメむン郚の「次を衚瀺」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ¬¡ã‚’è¡šç€ºã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'link' => 'http://mixi.jp/new_bbs.pl?page=2',
        'subject' => '次を衚瀺'
 }

=head3 $item = $mixi->parse_new_bbs_previous( [$response] );

コミュニティ最新曞き蟌みnew_bbs.plのメむン郚の「前を衚瀺」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œå‰ã‚’è¡šç€ºã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'link' => 'http://mixi.jp/new_bbs.pl?page=1',
        'subject' => '前を衚瀺'
 }

=head3 @items = $mixi->parse_new_comment( [$response] );

日蚘コメント蚘å
¥å±¥æ­ŽïŒˆnew_comment.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18 13:18'
 }

=head3 @items = $mixi->parse_new_friend_diary( [$response] );

マむミクシィ最新日蚘new_friend_diary.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18 13:18'
        'image' => {
                'link' => 'http://mixi.jp/ajax_new_diary.pl?friend_id=xxxxxx&type=1',
                'src' => 'http://img.mixi.jp/img/diary_open2.gif'
        }
 }

=head3 $item = $mixi->parse_new_friend_diary_next( [$response] );

マむミクシィ最新日蚘new_friend_diary.plのメむン郚の「次のペヌゞ」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ¬¡ã®ãƒšãƒŒã‚žã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '次のxx件を衚瀺',
        'link' => 'http://mixi.jp/new_friend_diary.pl?page=x',
 }

=head3 $item = $mixi->parse_new_friend_diary_previous( [$response] );

マむミクシィ最新日蚘new_friend_diary.plのメむン郚の「前のペヌゞ」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œå‰ã®ãƒšãƒŒã‚žã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '前の50件を衚瀺',
        'link' => 'http://mixi.jp/new_friend_diary.pl?page=x',
 }

=head3 @items = $mixi->parse_new_review( [$response] );

マむミクシィ最新レビュヌnew_review.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'mixiの本。',
        'link' => 'http://mixi.jp/list_item_review.pl?reviewer_id=xxxx&item_id=xxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18 13:18'
 }

=head3 @items = $mixi->parse_release_info( [$response] );

æ–°æ©ŸèƒœãƒªãƒªãƒŒã‚¹ãƒ»éšœå®³ã®ã”å ±å‘ŠïŒˆrelease_info.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => '「○○」に関しお',
        'time' => '2005/09/01',
        'description' => '「○○」のメンテナンスを行うため、9月1日(æ°Ž)11:10é ƒã‚ˆã‚Šã€â—‹â—‹ã‚’åœæ­¢ã„ãŸã—ãŸã™ã€‚
        ナヌザヌの皆様には倧倉ご䞍䟿をおかけいたしたすが、メンテナンス完了たでしばらくおåŸ
ちいただきたすようお願い申し䞊げたす。
        远蚘
        13:30é ƒã€ãƒ¡ãƒ³ãƒ†ãƒŠãƒ³ã‚¹ãŒå®Œäº†ã—ãŸã“ãšã‚’ãŠçŸ¥ã‚‰ã›è‡Žã—ãŸã™ã€‚'
 }

=head3 $id = $mixi->parse_self_id();

セッションIDを解析し、自分のIDを返したす。
IDを取埗できなかった時の返り倀は0です。

このメ゜ッドは他の倚くの解析系メ゜ッドず違い、ハッシュリファレンスのé
åˆ—ではなくただの文字列スカラ倀を返すこずに泚意しおください。

=head3 @items = $mixi->parse_search_diary( [$response] );

新着日蚘怜玢search_diary.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'description' => 'mixiはじめたした。皆様、よろしくお願いした',
        'time' => '2005/05/20 13:32'
        'name' => '塚本牧生',
        'gender' => '男性',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx&owner_id=xxxxx',
        'image' => 'http://img.mixi.jp/photo/member/xx/xx/xxxxx_xxxxxxxxs.jpg',
 }

=head3 $item = $mixi->parse_search_diary_next( [$response] );

新着日蚘怜玢search_diary.plのメむン郚の「次のペヌゞ」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ¬¡ã‚’è¡šç€ºã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '次を衚瀺',
        'link' => 'http://mixi.jp/search_diary.pl?page=2&keyword=xx'
 }

=head3 $item = $mixi->parse_search_diary_previous( [$response] );

新着日蚘怜玢search_diary.plのメむン郚の「前のペヌゞ」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œå‰ã‚’è¡šç€ºã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '前を衚瀺',
        'link' => 'http://mixi.jp/search_diary.pl?page=2&keyword=xx'
 }

=head3 @items = $mixi->parse_show_calendar( [$response] );

カレンダヌshow_calendar.plのメむン郚を解析したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => '誕生日',
        'link' => 'http://mixi.jp/view_event.pl?id=xxxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18'
        'icon' => 'http://mixi.jp/img/i_bd.gif'
 }

=head3 $item = $mixi->parse_show_calendar_term( [$response] );

カレンダヌshow_calendar.plのメむン郚の期間幎月を解析したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        'year' => '2004',
        'month' => '8'
 }

=head3 $item = $mixi->parse_show_calendar_next( [$response] );

カレンダヌshow_calendar.plのメむン郚の「次の月」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œæ¬¡ã®æœˆã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '次の月',
        'link' => 'http://mixi.jp/show_calendar.pl?year=2004&month=10&pref_id=13',
 }

=head3 $item = $mixi->parse_show_calendar_previous( [$response] );

カレンダヌshow_calendar.plのメむン郚の「前の月」ぞのリンクを解析したす。
è¿”ã‚Šå€€ã¯ã€ã€Œå‰ã®æœˆã€ãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'subject' => '前の月',
        'link' => 'http://mixi.jp/show_calendar.pl?year=2004&month=10&pref_id=13',
 }

=head3 $item = $mixi->parse_show_friend_outline( [$response] );

ニックネヌムや写真show_friend.plのプロフィヌル画像巊䞊郚を解析したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        'name' => 'たきお',
        'link' => 'http://mixi.jp/show_friend.pl?id=xxx',
        'image' => 'http://img.mixi.jp/photo/member/xx/xx/xxx_xxxxxxxxxx.jpg',
        'description' => '最終ログむンは5時間以å†
',
        'count' => 20,
        'step' => 2,
        'relation' => {
                'link' => 'http://mixi.jp/show_friend.pl?id=xxx',
                'name' => 'walrus'
        }
 }

stepã¯ãƒžã‚€ãƒŸã‚¯ã‚·ã‚£ã®å Žåˆ1ã€ãƒžã‚€ãƒŸã‚¯ã‚·ã‚£ã®ãƒžã‚€ãƒŸã‚¯ã‚·ã‚£ã®å Žåˆ2ã€ã©ã¡ã‚‰ã§ã‚‚ãªã„å Žåˆ0です。
stepが2の時は䞊のように、間に挟たるマむミクシィのæƒ
å ±ãŒrelationにセットされたす。

=head3 $item = $mixi->parse_show_friend_profile( [$response] );

プロフィヌルshow_friend.plのメむン郚を解析し、プロフィヌルを返したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        '珟䜏所' => '東京郜高坂区',
        'å¥œããªæ˜ ç”»' => 'ゞャッカルの日',
        '所属' => 'æ ªåŒäŒšç€Ÿã‚¿ã‚«ã‚µã‚«ã‚¯',
        '出身地' => '埌玉県坂槻垂',
        '幎霢' => '30歳',
        '名前' => '塚本 牧生 (男性)',
        '血液型' => 'O型',
        '職業' => 'プログラマ',
        '趣味' => 'æ˜ ç”»é‘‘è³ž, 読曞',
        '奜きな本・マンガ' => '薔薇の名前',
        '誕生日' => '01月01日',
        '自己玹介' => 'こんにちはヌ。'
 }

ハッシュのé 
目は、その人のå
¬é–‹ã—おいるプロフィヌルのå†
容によっお増枛したす。

=head3 @items = $mixi->parse_show_intro( [$response] );

マむミクシィからの玹介文show_intro.plのメむン郚を解析し、玹介文を返したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        'description' => 'い぀もい぀もWWW::Mixiな人です。',
        'name' => 'walrus',
        'link' => 'http://mixi.jp/show_friend.pl?id=xxxx',
        'image' => 'http://img.mixi.jp/photo/member/xx/xx/xxxx_xxxxxxxxs.jpg'
        'introduction' => '0',
        'detele' => '1',
        'relation' => '',
 }

=head3 @items = $mixi->parse_show_log( [$response] );

あしあずshow_log.plのメむン郚を解析し、あしあずを返したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'link' => 'http://mixi.jp/show_friend.pl?id=xxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18 13:18'
 }

=head3 $count = $mixi->parse_show_log_count( [$response] );

あしあずshow_log.plのメむン郚を解析し、あしあず数を返したす。

このメ゜ッドは他の倚くの解析系メ゜ッドず違い、ハッシュリファレンスのé
åˆ—ではなくただの数倀スカラ倀を返すこずに泚意しおください。

=head3 @items = $mixi->parse_view_album( [$response] );

フォトアルバムview_album.plのメむン郚を解析し、アルバムのæƒ
å ±ã‚’è¿”ã—ãŸã™ã€‚

 {
        'subject' => '10月1日のアルバム',
        'time' => '2005/10/01 15:15',
        'name' => 'walrus',
        'description' => '10月1日のパヌティヌの時の写真です。
 他にもずっお人がいたら教えおくださいたせ',
        'image' => 'http://img1.mixi.jp/photo/album/xx/xx/xxxx_xxxxxxxxs.jpg',
        'level' => '友人たでå
¬é–‹',
        'photo_number' => '7',
        'comment_number' => '0'
 }

=head3 @items = $mixi->parse_view_album_comment( [$response] );

フォトアルバムview_album.pl?mode=commentのメむン郚を解析し、コメントを返したす。
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'link' => 'http://mixi.jp/show_friend.pl?id=xxxx',
        'time' => '2005/10/02 01:19',
        'name' => 'walrus',
        'description' => 'いいなぁ、楜しそうだなぁ。
 僕も行きたかったです。'
 }

=head3 @items = $mixi->parse_view_album_photo( [$response] );

フォトアルバムview_album.plの写真䞀芧を解析し、写真のæƒ
å ±ã‚’è¿”ã—ãŸã™ã€‚
返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'パヌティヌ開始。',
        'link' => 'http://mixi.jp/view_album_photo.pl?album_id=xxxx&number=xxxxxxxx&page=1',
        'thumb_link' => 'http://img1.mixi.jp/photo/album/x/xx/xxxx_xxxxxxxxs.jpg',
        'description' => 'xxxx_xxxxxxxxs.jpg'
 }

=head3 $item = $mixi->parse_view_bbs( [$response] );

トピックview_bbs.plのメむン郚を解析したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        'link' => 'http://mixi.jp/view_bbs.pl?id=xxxxxx',
        'images' => [
                {
                        'thumb_link' => 'http://img1.mixi.jp/photo/bbs/xx/xx/xxxxxxx_xxs.jpg',
                        'link' => 'show_picture.pl?img_src=http://img1.mixi.jp/photo/bbs/xx/xx/xxxxxxx_xx.jpg'}
                },
        ],
        'subject' => 'リリヌスæƒ
å ±',
        'time' => '2005/09/01 00:00',
        'name' => 'walrus',
        'name_link' => 'http://mixi.jp/show_friend.pl?id=xxxxx',
        'description' => 'リリヌスæƒ
å ±ã¯ã“ã®ãƒˆãƒ”ãƒƒã‚¯ã«æŽ²èŒ‰ã—ãŠã„ããŸã™ã€‚'
        'comments' => [
                {
                        'link' => 'http://mixi.jp/show_friend.pl?id=xxxxx',
                        'time' => '2005/09/01 05:34',
                        'name' => 'walrus',
                        'description' => '1.00版をリリヌスしたした。'
                }
        ]
 }

=head3 $item = $mixi->parse_view_diary( [$response] );

日蚘view_diary.plのメむン郚を解析したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        'subject'     => 'こんにちは。',
        'link'        => 'http://mixi.jp/view_diary.pl?id=xxxxxx',
        'description' => '本文',
        'time'        => '2005/05/24 22:36'
        'level' => {
                'description' => 'å
šäœ“にå
¬é–‹'
                'link' => 'http://img.mixi.jp/img/diary_icon3.gif',
        },
        'images'      => [
                {
                        'link'        => 'http://img.mixi.jp/photo/diary/xx/xx/xxxxxxxxx_xxx.jpg',
                        'thumb_link'  => 'http://img.mixi.jp/photo/diary/xx/xx/xxxxxxxxx_xxxs.jpg'
                }
        ]
        'comments'    => [
                {
                        'link' => 'http://mixi.jp/show_friend.pl?id=xxxxxx',
                        'time' => '2005/05/24 22:56',
                        'name' => 'コメンタヌ',
                        'description' => 'こんにちは。'
                },
        ]
 }

images、commentsは0件の時も、耇数件の時もあるこずに泚意しおください。

=head3 @items = $mixi->parse_view_event( [$response] );

むベントview_event.plのメむン郚を解析したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        'subject' => '10月蚘念パヌティ。',
        'link' => 'http://mixi.jp/view_event.pl?id=xxxxxxxx',
        'time' => '2005/09/15 02:45',
        'date' => '2005幎10月01日(午埌)',
        'deadline' => '指定なし',
        'location' => 'レストランお茶の間',
        'description' => '10月を蚘念しおパヌティヌしたしょう',
        'images' => [],
        'name' => 'waltus',
        'name_link' => 'http://mixi.jp/show_friend.pl?id=xxxx'
        'join' => 5,
        'community' => {
                'link' => 'http://mixi.jp/view_community.pl?id=xxxxx',
                'name' => '毎月コングラチュレヌションズ'
        },
        'list' => {
                'count' => '8人',
                'link' => 'http://mixi.jp/list_event_member.pl?id=xxxxxxx&comm_id=xxxxx',
                'subject' => 'å‚åŠ è€
䞀芧を芋る'
        },
        'comments' => [
                {
                        'subject' => 1,
                        'name' => 'seiuchi',
                        'link' => 'http://mixi.jp/show_friend.pl?id=xxxx',
                        'time' => '2005/09/21 15:15',
                        'description' => 'å‚åŠ ã—ãŸã™ã€‚ã‚ˆã‚ã—ãïŒ'
                        'images' => [],
                }
        ],
        'pages' => [
                {
                        'current' => 1,
                        'link' => 'http://mixi.jp/view_event.pl?comm_id=29659&id=6366972',
                        'subject' => '最新の10件を衚瀺'
                }
        ]
 }

images、comments、pagesは0件の時も、耇数件の時もあるこずに泚意しおください。

=head3 $item = $mixi->parse_view_message( [$response] );

受信メッセヌゞたたは送信枈みメッセヌゞview_message.plのメむン郚のメッセヌゞを解析したす。
返り倀は、メッセヌゞを取埗できたずきは以䞋のようなハッシュリファレンスです。

 {
        'subject'     => 'こんにちわ。',
        'image'       => 'http://img.mixi.jp/photo/member/xx/xx/xxxxxx_xxxxxxxxs.jpg',
        'link'        => 'http://mixi.jp/show_friend.pl?id=?id=xxxxxx',
        'name'        => '塚本牧生',
        'time'        => '2004/08/18 12:34',
        'description' => '本文...',
 }

=head3 @items = $mixi->parse_view_message_form( [$response] );

受信メッセヌゞview_message.plのメむン郚のメッセヌゞ削陀、返信などのフォヌムを解析したす。
返り倀は、フォヌムごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'command' => 'delete_message'
        'action' => 'http://mixi.jp/delete_message.pl?box=xxxxx&message_id=xxxxxxx',
        'submit' => '削 陀',
 }

各フォヌムは、actionに察応する倀のURLに察しお、フォヌムé 
目submitずしおsubmitに察応する倀だけをpostで送信するものです。

=head3 @items = $mixi->parse_add_diary_preview( [$response ]);

日蚘䜜成のプレビュヌadd_diary.plのメむン郚を解析し、各ボタンに盞圓するフォヌムの倀を返したす。
返り倀は、フォヌムごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        '__action__' => 'http://mixi.jp/show_friend.pl?id=xxxxx',
        'submit' => 'confirm',
        'diary_title' => '今日の日蚘',
        'diary_body' => '今日は朝から晩だった。
 生たれたばかりの...',
        'packed' => 'asjkEKJHFu.16190.diary:1:adjksHfsdk.16190.diary_s:1',
        'post_key' => '012a34b56cd78e901fa23b45678cde90',
 }

__action__ずいうキヌがあるこずに泚意しおください。
これはこのフォヌムの送信å
ˆURLを衚しおいるもので、フォヌム倀ではありたせん。
日蚘を䜜成するconfirmする時には、このキヌは削陀しおおくå¿
芁がありたす。

'post_key'は自動的にmixi偎からランダムな文字列が返されたす。
たた、'packed'はプレビュヌ取埗時に画像ファむルをおくっおいれば、同じくmixi偎からランダムな文字列が返されたす。
日蚘を投皿するpostたたはget_edit_diary_confirm際にはプレビュヌで取埗したこれらの倀もå¿
芁です。

=head3 $item = $mixi->parse_add_diary_confirm( [$response ]);

日蚘䜜成結果add_diary.plのメむン郚を解析したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        'link' => 'http://mixi.jp/list_diary.pl',
        'subject' => 'äœœæˆãŒå®Œäº†ã—ãŸã—ãŸã€‚åæ˜ ã«æ™‚é–“ãŒã‹ã‹ã‚‹ã“ãšãŒã‚ã‚ŠãŸã™ã®ã§ã€è¡šç€ºã•ã‚ŒãŠã„ãªã„å Žåˆã¯å°‘ã€
おåŸ
ちください。',
        'result' => 1
 }

なお、コンテンツに「䜜成が完了したした。」のメッセヌゞが芋぀からない時は、返り倀はありたせん。
たた、レスポンスが「デヌタはありたせん。」だった時にも、返り倀はありたせん。
ã©ã¡ã‚‰ã®å Žåˆã‚‚ã€ãŠãã‚‰ããƒ¡ãƒƒã‚»ãƒŒã‚žé€ä¿¡ã¯å€±æ•—ã—ãŠã„ãŸã™ã€‚
è¿”ã‚Šå€€ãŒãªã‹ã£ãŸå Žåˆã€ãƒ¬ã‚¹ãƒãƒ³ã‚¹ã‚³ãƒŒãƒ‰ãŒ200であればレスポンスのコンテンツを、400であればレスポンスメッセヌゞをチェックしおみおください。

=head3 @items = $mixi->parse_delete_diary_preview( [$response ]);

日蚘削陀のプレビュヌdelete_diary.plのメむン郚を解析し、各ボタンに盞圓するフォヌムの倀を返したす。
返り倀は、フォヌムごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        '__action__' => 'http://mixi.jp/delete_dairy.pl?id=xxxxx',
        'submit' => 'confirm',
 }

__action__ずいうキヌがあるこずに泚意しおください。
これはこのフォヌムの送信å
ˆURLを衚しおいるもので、フォヌム倀ではありたせん。
日蚘を削陀するconfirmする時には、このキヌは削陀しおおくå¿
芁がありたす。

=head3 $item = $mixi->parse_delete_diary_confirm( [$response ]);

日蚘削陀結果delete_diary.plのメむン郚を解析したす。
日蚘の削陀は成功時、レスポンスコヌド302によっお日蚘list_diary.plにリダむレクトされたすので、解析結果はparse_list_diaryメ゜ッドず同じになりたす。

返り倀がなかったずきは、レスポンスコヌドず、レスポンスのpreviousメ゜ッドで取埗できるリダむレクトの履歎およびその際のレスポンスコヌドをチェックしおみおください。

=head3 @items = $mixi->parse_edit_diary_preview( [$response ]);

日蚘線集のプレビュヌedit_diary.plのメむン郚を解析し、各フォヌムの倀を返したす。
返り倀は、フォヌムごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        '__action__' => 'http://mixi.jp/edit_diary.pl?id=xxxxx',
        'submit' => 'main',
        'diary_title' => '今日の日蚘',
        'diary_body' => '今日は朝から晩だった。
 生たれたばかりの...',
        'form_date' => 'date',
        'photo1' => '',
        'photo2' => '',
        'photo3' => '',
 }

__action__ずいうキヌがあるこずに泚意しおください。
これはこのフォヌムの送信å
ˆURLを衚しおいるもので、フォヌム倀ではありたせん。
線集å†
容を確定する時には、このキヌは削陀しおおくå¿
芁がありたす。

=head3 @items = $mixi->parse_edit_diary_image( [$response ]);

日蚘線集のプレビュヌedit_diary.plのメむン郚を解析したす。
返り倀は、フォヌムごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'thumb_link' => 'http://img1.mixi.jp/photo/diary/xx/xx/xxxxx_xxxs.jpg',
        'subject' => '写真1',
        'link' => 'http://mixi.jp/delete_diary_photo.pl?diary_id=xxxxx&photo_number=xxx'
 }

'link'に察応するURLは、この写真を削陀するためのものです。

=head3 $item = $mixi->parse_edit_diary_confirm( [$response ]);

日蚘線集結果edit_diary.plのメむン郚を解析したす。
日蚘の線集は成功時、レスポンスコヌド302によっお日蚘list_diary.plにリダむレクトされたすので、解析結果はparse_list_diaryメ゜ッドず同じになりたす。

返り倀がなかったずきは、レスポンスコヌドず、レスポンスのpreviousメ゜ッドで取埗できるリダむレクトの履歎およびその際のレスポンスコヌドをチェックしおみおください。

=head3 $item = $mixi->parse_send_message_preview( [$response ]);

メッセヌゞ送信のプレビュヌsend_message.plのメむン郚を解析し、フォヌムデヌタを返したす。
返り倀は以䞋のようなハッシュリファレンスです。

 {
        '__action__' => 'http://mixi.jp/send_message.pl?id=267049',
        'subject' => '今日の手玙。',
        'body' => '今日は朝から晩だった。
 生たれたばかりの...',
        'submit' => 'confirm',
        'yes' => '　送　信　',
        'no' => '　修  正　',
        'post_key' => '777c74e88ba28b909be01d31082daa67',
 }

__action__ずいうキヌがあるこずに泚意しおください。
これはこのフォヌムの送信å
ˆURLを衚しおいるもので、フォヌム倀ではありたせん。

'post_key'は自動的にmixi偎からランダムな文字列が返されたす。
メッセヌゞを送信するpostたたはget_edit_diary_confirm際にはプレビュヌで取埗したこれらの倀もå¿
芁です。

ãªãŠã€ã‚šãƒ©ãƒŒãŒã‚ã‚‹å Žåˆã€parse_send_message_previewはレスポンスコヌドを400、レスポンスメッセヌゞを"Invalid Form Data"に倉曎したす。
è¿”ã‚Šå€€ãŒãªã‹ã£ãŸå Žåˆã€å†åºŠãƒ¬ã‚¹ãƒãƒ³ã‚¹ã‚³ãƒŒãƒ‰ã‚’ãƒã‚§ãƒƒã‚¯ã—ãŠã¿ãŠãã ã•ã„ã€‚

=head3 $item = $mixi->parse_send_message_confirm( [$response ]);

メッセヌゞ送信結果send_message.plのメむン郚を解析したす。
返り倀は、以䞋のようなハッシュリファレンスです。

 {
        'result' => 1,
        'subject' => '送信完了したした。'
        'banner' => {
                'subject' => '',
                'image' => 'http://img.mixi.jp/img/banner/yosoo03.gif',
                'link' => 'http://mixi.jp/banner.pl?id=63'
        },
 }

なお、コンテンツに「送信完了したした。」のメッセヌゞが芋぀からない時は、返り倀はありたせん。
たた、レスポンスが「デヌタはありたせん。」だった時にも、返り倀はありたせん。
ã©ã¡ã‚‰ã®å Žåˆã‚‚ã€ãŠãã‚‰ããƒ¡ãƒƒã‚»ãƒŒã‚žé€ä¿¡ã¯å€±æ•—ã—ãŠã„ãŸã™ã€‚
è¿”ã‚Šå€€ãŒãªã‹ã£ãŸå Žåˆã€ãƒ¬ã‚¹ãƒãƒ³ã‚¹ã‚³ãƒŒãƒ‰ãŒ200であればレスポンスのコンテンツを、400であればレスポンスメッセヌゞをチェックしおみおください。

=head2 Fetch data

盎接デヌタを取埗するためのメ゜ッドです。

実際には、å†
郚で自動的にペヌゞの取埗ず解析が行われたす。
返り倀は、䜿甚される解析メ゜ッドparse_に準じたす。

デヌタ取埗メ゜ッドはコヌディングを簡単にしたすが、返り倀がないずきにぱラヌが起きたのか、それずも本圓に該圓レコヌドがないのかの刀断が難しいこずに泚意しおください。
こうした時には、logメ゜ッドを䞊曞きしおおいお゚ラヌメッセヌゞ等を拟う、responseメ゜ッドで盎接HTTPレスポンスを取埗しお解析する、ずいった方法を考えおくださいずは蚀え、そこたでしおしたうずgetメ゜ッドparse_メ゜ッドを䜿うより手間でしょう。

=head3 @items = $mixi->get_main_menu( [$url | $url => 'refresh'] )

指定されたURLのメむンメニュヌを取埗したす。
返り倀はparse_main_menuず同じです。

指定されたURLが最埌にgetたたはpostメ゜ッドで取埗したURLず同じずき、たたはURLが指定されなかったずきは、最埌にgetたたはpostメ゜ッドで取埗したデヌタのメむンメニュヌを返したす。
同䞀URLでも再取埗したいずきには、'refresh'を指定しおください。

=head3 @items = $mixi->get_banner( [$url | $url => 'refresh'] )

指定されたURLのバナヌを取埗したす。
返り倀はparse_bannerず同じです。

指定されたURLが最埌にgetたたはpostメ゜ッドで取埗したURLず同じずき、たたはURLが指定されなかったずきは、最埌にgetたたはpostメ゜ッドで取埗したデヌタのメむンメニュヌを返したす。
同䞀URLでも再取埗したいずきには、'refresh'を指定しおください。

=head3 @items = $mixi->get_tool_bar( [$url | $url => 'refresh'] )

指定されたURLのツヌルバヌを取埗したす。
返り倀はparse_tool_barず同じです。

指定されたURLが最埌にgetたたはpostメ゜ッドで取埗したURLず同じずき、たたはURLが指定されなかったずきは、最埌にgetたたはpostメ゜ッドで取埗したデヌタのメむンメニュヌを返したす。
同䞀URLでも再取埗したいずきには、'refresh'を指定しおください。

=head3 @items = $mixi->get_information( [$url | $url => 'refresh' | 'refresh'] );

指定されたURLから、「管理è€
からのお知らせ」を取埗したす。
URLを指定しなかった時は「ホヌム」を察象にしたす。
返り倀はparse_informationず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_home_new_album( [$url | $url => 'refresh' | 'refresh'] );

指定されたURLから、「マむミクシィ最新アルバム」を取埗したす。
URLを指定しなかった時は「ホヌム」を察象にしたす。
返り倀はparse_home_new_albumず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_home_new_bbs( [$url | $url => 'refresh' | 'refresh'] );

指定されたURLから、「コミュニティ最新曞き蟌み」を取埗したす。
URLを指定しなかった時は「ホヌム」を察象にしたす。
返り倀はparse_home_new_bbsず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_home_new_comment( [$url | $url => 'refresh' | 'refresh'] );

指定されたURLから、「日蚘コメント蚘å
¥å±¥æ­Žã€ã‚’取埗したす。
URLを指定しなかった時は「ホヌム」を察象にしたす。
返り倀はparse_home_new_commentず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_home_new_friend_diary( [$url | $url => 'refresh' | 'refresh'] );

指定されたURLから、「マむミクシィ最新日蚘」を取埗したす。
URLを指定しなかった時は「ホヌム」を察象にしたす。
返り倀はparse_home_new_friend_diaryず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_home_new_review( [$url | $url => 'refresh' | 'refresh'] );

指定されたURLから、「マむミクシィ最新レビュヌ」を取埗したす。
URLを指定しなかった時は「ホヌム」を察象にしたす。
返り倀はparse_home_new_reviewず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_ajax_new_diary( $url [, 'refresh'] | 'friend_id' => $id  [, 'refresh'] );

むベントを取埗したす。
このメ゜ッドでは、URLか、マむミクシィのIDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_ajax_new_diaryず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_community_id( $url | $url => 'refresh' );

コミュニティのIDを取埗したす。
このメ゜ッドでは、URLの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_community_idず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_bbs( $url | $url => 'refresh' | 'refresh', 'id' => $community_id | 'id' => $community_id);

コミュニティのトピック䞀芧を取埗したす。
このメ゜ッドでは、コミュニティIDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_list_bbsず同じです。

コミュニティIDは、URLのク゚リ郚で'id=xxxxx'のように指定するか、匕数で䞎えおください。
äž¡æ–¹æŒ‡å®šã•ã‚ŒãŸå Žåˆã¯ã€URL䞭のコミュニティIDが優å
ˆã•ã‚ŒãŸã™ã€‚

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_bbs_next( $url | $url => 'refresh' | 'refresh', 'id' => $community_id | 'id' => $community_id);

コミュニティのトピック䞀芧の「次のペヌゞ」ぞのリンクを取埗したす。
このメ゜ッドでは、コミュニティIDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_list_bbs_nextず同じです。

コミュニティIDは、URLのク゚リ郚で'id=xxxxx'のように指定するか、匕数で䞎えおください。
äž¡æ–¹æŒ‡å®šã•ã‚ŒãŸå Žåˆã¯ã€URL䞭のコミュニティIDが優å
ˆã•ã‚ŒãŸã™ã€‚

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_bbs_previous( $url | $url => 'refresh' | 'refresh', 'id' => $community_id | 'id' => $community_id);

コミュニティのトピック䞀芧の「前のペヌゞ」ぞのリンクを取埗したす。
このメ゜ッドでは、コミュニティIDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_list_bbs_previousず同じです。

コミュニティIDは、URLのク゚リ郚で'id=xxxxx'のように指定するか、匕数で䞎えおください。
äž¡æ–¹æŒ‡å®šã•ã‚ŒãŸå Žåˆã¯ã€URL䞭のコミュニティIDが優å
ˆã•ã‚ŒãŸã™ã€‚

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_bookmark( [$url | $url => 'refresh' | 'refresh'] );

お気にå
¥ã‚Šã‚’取埗したす。
デフォルトではホヌムの「お気にå
¥ã‚Šã€ã‚’察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_bookmarkず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_comment( [$url | $url => 'refresh' | 'refresh'] );

最新のコメントを取埗したす。
デフォルトでは「最新のコメント」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_commentず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_community( [$url | $url => 'refresh' | 'refresh'] );

コミュニティ䞀芧を取埗したす。
デフォルトでは「コミュニティ䞀芧」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_communityず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_community_next( [$url | $url => 'refresh' | 'refresh'] );

コミュニティ䞀芧の「次のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「コミュニティ䞀芧」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_community_nextず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_community_previous( [$url | $url => 'refresh' | 'refresh'] );

コミュニティ䞀芧の「前のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「コミュニティ䞀芧」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_community_previousず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_diary( [$url | $url => 'refresh' | 'refresh'] );

日蚘䞀芧を取埗したす。
デフォルトでは「日蚘」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_diaryず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_diary_capacity( [$url | $url => 'refresh' | 'refresh'] );

日蚘の「日蚘の䜿甚状況」を取埗したす。
デフォルトでは「日蚘」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_diary_capacityず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_diary_next( [$url | $url => 'refresh' | 'refresh'] );

日蚘の「次のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「日蚘」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_diary_nextず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_diary_previous( [$url | $url => 'refresh' | 'refresh'] );

日蚘の「前のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「日蚘」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_diary_previousず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_diary_monthly_menu( [$url | $url => 'refresh' | 'refresh'] );

日蚘の各月のむンデックスぞのリンクを取埗したす。
デフォルトでは「日蚘」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_diary_monthly_menuず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_friend( [$url | $url => 'refresh' | 'refresh'] );

友人・知人䞀芧を取埗したす。
デフォルトでは「友人・知人䞀芧」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_friendず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_friend_next( [$url | $url => 'refresh' | 'refresh'] );

友人・知人䞀芧の「次のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「友人・知人䞀芧」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_friend_nextず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_friend_previous( [$url | $url => 'refresh' | 'refresh'] );

友人・知人䞀芧の「前のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「友人・知人䞀芧」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_friend_previousず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_member( $url | $url => 'refresh' | 'refresh', 'id' => $community_id | 'id' => $community_id);

コミュニティのメンバヌ䞀芧を取埗したす。
このメ゜ッドでは、コミュニティIDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_list_memberず同じです。

コミュニティIDは、URLのク゚リ郚で'id=xxxxx'のように指定するか、匕数で䞎えおください。
äž¡æ–¹æŒ‡å®šã•ã‚ŒãŸå Žåˆã¯ã€URL䞭のコミュニティIDが優å
ˆã•ã‚ŒãŸã™ã€‚

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_member_next( $url | $url => 'refresh' | 'refresh', 'id' => $community_id | 'id' => $community_id);

コミュニティのメンバヌ䞀芧の「次のペヌゞ」ぞのリンクを取埗したす。
このメ゜ッドでは、コミュニティIDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_list_member_nextず同じです。

コミュニティIDは、URLのク゚リ郚で'id=xxxxx'のように指定するか、匕数で䞎えおください。
äž¡æ–¹æŒ‡å®šã•ã‚ŒãŸå Žåˆã¯ã€URL䞭のコミュニティIDが優å
ˆã•ã‚ŒãŸã™ã€‚

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_list_member_previous( $url | $url => 'refresh' | 'refresh', 'id' => $community_id | 'id' => $community_id);

コミュニティのメンバヌ䞀芧の「前のペヌゞ」ぞのリンクを取埗したす。
このメ゜ッドでは、コミュニティIDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_list_member_previousず同じです。

コミュニティIDは、URLのク゚リ郚で'id=xxxxx'のように指定するか、匕数で䞎えおください。
äž¡æ–¹æŒ‡å®šã•ã‚ŒãŸå Žåˆã¯ã€URL䞭のコミュニティIDが優å
ˆã•ã‚ŒãŸã™ã€‚

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_message( [$url | $url => 'refresh' | 'refresh'] );

「最近の受信メッセヌゞ」を取埗したす。
デフォルトでは「最近の受信メッセヌゞ」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_messageず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_list_outbox( [$url | $url => 'refresh' | 'refresh'] );

「最近の送信メッセヌゞ」を取埗したす。
デフォルトでは「送信メッセヌゞ」の最初のペヌゞを察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_messageず同じです。

=head3 @items = $mixi->get_list_request( [$url | $url => 'refresh' | 'refresh'] );

「承認åŸ
ちの友人」を取埗したす。
デフォルトでは「承認åŸ
ちの友人」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_list_requestず同じです。

=head3 @items = $mixi->get_new_album( [$url | $url => 'refresh' | 'refresh'] );

マむミクシィ最新アルバムを取埗したす。
デフォルトでは「マむミクシィ最新アルバム」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_albumず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_new_bbs( [$url | $url => 'refresh' | 'refresh'] );

コミュニティ最新曞き蟌みを取埗したす。
デフォルトでは「コミュニティ最新曞蟌み」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_bbsず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_new_bbs_next( [$url | $url => 'refresh' | 'refresh'] );

コミュニティ最新曞き蟌みの「次のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「コミュニティ最新曞き蟌み」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_bbs_nextず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_new_bbs_previous( [$url | $url => 'refresh' | 'refresh'] );

コミュニティ最新曞き蟌みの「前のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「コミュニティ最新曞き蟌み」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_bbs_previousず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_new_comment( [$url | $url => 'refresh' | 'refresh'] );

日蚘コメント蚘å
¥å±¥æ­Žã‚’取埗したす。
デフォルトでは「日蚘コメント蚘å
¥å±¥æ­Žã€ã‚’察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_commentず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_new_friend_diary( [$url | $url => 'refresh' | 'refresh'] );

マむミクシィ最新日蚘を取埗したす。
デフォルトでは「マむミクシィ最新日蚘」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_friend_diaryず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_new_friend_diary_next( [$url | $url => 'refresh' | 'refresh'] );

マむミクシィ最新日蚘の「次のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「マむミクシィ最新日蚘」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_friend_diary_nextず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_new_friend_diary_previous( [$url | $url => 'refresh' | 'refresh'] );

マむミクシィ最新日蚘の「前のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「マむミクシィ最新日蚘」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_friend_diary_previousず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_new_review( [$url | $url => 'refresh' | 'refresh'] );

マむミクシィ最新レビュヌを取埗したす。
デフォルトでは「マむミクシィ最新レビュヌ」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_new_reviewず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_release_info( [$url | $url => 'refresh' | 'refresh'] );

æ–°æ©ŸèƒœãƒªãƒªãƒŒã‚¹ãƒ»éšœå®³ã®ã”å ±å‘Šã‚’å–åŸ—ã—ãŸã™ã€‚
ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆã§ã¯ã€Œæ–°æ©ŸèƒœãƒªãƒªãƒŒã‚¹ãƒ»éšœå®³ã®ã”å ±å‘Šã€ã‚’å¯Ÿè±¡ã«ã—ãŸã™ãŒã€URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_release_infoず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $id = $mixi->get_self_id();

ログむン時に䞎えられたセッションIDから、セッションIDを取埗したす。
返り倀はparse_self_idず同じです。

未ログむン時はログむンを行いたす。

=head3 @items = $mixi->get_search_diary( [$url | $url => 'refresh' | 'refresh']  [,'keyword' => $keyword]);

新着日蚘怜玢を取埗したす。
デフォルトでは「新着日蚘怜玢」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_search_diaryず同じです。

怜玢キヌワヌドを指定する時は、URLに埋め蟌むか、匕数で䞎えおください。
どちらもなければ怜玢キヌワヌド無しでの怜玢結果が返されたす。
äž¡æ–¹æŒ‡å®šã•ã‚ŒãŸå Žåˆã¯ã€URL䞭のキヌワヌドが優å
ˆã•ã‚ŒãŸã™ã€‚

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_search_diary_next( [$url | $url => 'refresh' | 'refresh'] [,'keyword' => $keyword]);

新着日蚘怜玢の「次のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「新着日蚘怜玢」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_search_diary_nextず同じです。

怜玢キヌワヌドは、URLに埋め蟌むか、匕数で䞎えおください。
新着日蚘怜玢ではキヌワヌドを指定しないず「次のペヌゞ」「前のペヌゞ」が芋れないので、URL䞭にも匕数にもキヌワヌドがない時は、確実に倱敗するこずに泚意しおください。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_search_diary_previous( [$url | $url => 'refresh' | 'refresh']  [,'keyword' => $keyword]);

新着日蚘怜玢の「前のペヌゞ」ぞのリンクを取埗したす。
デフォルトでは「新着日蚘怜玢」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_search_diary_previousず同じです。

怜玢キヌワヌドは、URLに埋め蟌むか、匕数で䞎えおください。
新着日蚘怜玢ではキヌワヌドを指定しないず「次のペヌゞ」「前のペヌゞ」が芋れないので、URL䞭にも匕数にもキヌワヌドがない時は、確実に倱敗するこずに泚意しおください。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_show_calendar( [$url | $url => 'refresh' | 'refresh'] );

カレンダヌを取埗したす。
デフォルトでは今月のカレンダヌを察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_show_calendarず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_show_calendar_term( [$url | $url => 'refresh' | 'refresh'] );

カレンダヌの期間幎月を取埗したす。
デフォルトでは今月のカレンダヌを察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_show_calendar_termず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_show_calendar_next( [$url | $url => 'refresh' | 'refresh'] );

カレンダヌの「次の月」ぞのリンクを取埗したす。
デフォルトでは「カレンダヌ」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_show_calendar_nextず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_show_calendar_previous( [$url | $url => 'refresh' | 'refresh'] );

カレンダヌの「前の月」ぞのリンクを取埗したす。
デフォルトでは「カレンダヌ」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_show_calendar_previousず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_show_intro( [$url | $url => 'refresh' | 'refresh'] );

玹介文を取埗したす。
デフォルトでは「マむミクシィからの玹介文」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_show_introず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_show_log( [$url | $url => 'refresh' | 'refresh'] );

あしあずを取埗したす。
デフォルトでは「あしあず」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_show_logず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $count = $mixi->get_show_log_count( [$url | $url => 'refresh' | 'refresh'] );

あしあず数を取埗したす。
デフォルトでは「あしあず」を察象にしたすが、URLを指定した時はそのペヌゞを察象にしたす。
返り倀はparse_show_log_countず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_show_friend_outline( $url [ => 'refresh'] );

ニックネヌムや写真などのæƒ
å ±ã‚’å–åŸ—ã—ãŸã™ã€‚
このメ゜ッドでは、URLの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_show_friend_outlineず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_show_friend_profile( $url [ => 'refresh'] );

プロフィヌルを取埗したす。
このメ゜ッドでは、URLの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_show_friend_profileず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_view_album( $url [, 'refresh'] | 'id' => $id  [, 'refresh'] );

アルバムの抂芁を取埗したす。
このメ゜ッドでは、URLか、IDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_view_albumず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_view_album_comment( $url [, 'refresh'] | 'id' => $id  [, 'refresh'] );

アルバムのコメントを取埗したす。
このメ゜ッドでは、URLか、IDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_view_album_commentず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_view_album_photo( $url [, 'refresh'] | 'id' => $id  [, 'refresh'] );

アルバムの写真を取埗したす。
このメ゜ッドでは、URLか、IDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_view_album_photoず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_view_bbs( $url [ => 'refresh'] );

トピックを取埗したす。
このメ゜ッドでは、URLの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_view_bbsず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_view_diary( $url [ => 'refresh'] );

日蚘を取埗したす。
このメ゜ッドでは、URLの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_view_diaryず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_view_event( $url [, 'refresh'] | 'id' => $id  [, 'refresh'] );

むベントを取埗したす。
このメ゜ッドでは、URLか、IDの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_view_eventず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 $item = $mixi->get_view_message( $url [ => 'refresh'] );

メッセヌゞを取埗したす。
このメ゜ッドでは、URLの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_view_messageず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head3 @items = $mixi->get_view_message_form( $url [ => 'refresh'] );

メッセヌゞを取埗したす。
このメ゜ッドでは、URLの指定がå¿
é ˆã§ã™ã€‚
返り倀はparse_view_messageず同じです。

最埌にgetたたはpostメ゜ッドで取埗したペヌゞが察象URLず同じ時は、その時のデヌタを返したす。
最新のデヌタを取埗したい時は、'refresh'を指定しおください。

=head2 Post data

盎接デヌタを投皿するためのメ゜ッドです。

実際には、å†
郚で自動的に適切なペヌゞぞのpostが行われたす。

=head3 @items = $mixi->get_add_diary_preview('diary_title' => $title, 'diary_body' => $body [, 'photo1' => $path_to_photo1] [, 'photo2' => $path_to_photo2] [, 'photo3' => $path_to_photo3]);

日蚘䜜成ペヌゞに匕数のデヌタを送信し、プレビュヌペヌゞを取埗しお解析したす。
返り倀はparse_add_diary_previewず同じです。

=head3 @items = $mixi->get_add_diary_confirm('diary_title' => $title, 'diary_body' => $body, 'post_key' => $key [, 'photo1' => $path_to_photo1] [, 'photo2' => $path_to_photo2] [, 'photo3' => $path_to_photo3]);

日蚘を投皿したす。
返り倀はparse_add_diary_confirmず同じです。

=head3 @items = $mixi->get_delete_diary_preview('id' => $id);

日蚘削陀の確認画面を取埗し、解析したす。
返り倀はparse_delete_diary_previewず同じです。

=head3 @items = $mixi->get_delete_diary_confirm('id' => $id, 'post_key' => $key);

日蚘を削陀したす。
返り倀はparse_delete_diary_confirmず同じです。

=head3 @items = $mixi->get_edit_diary_preview($url|'id' => $id);

日蚘を線集再投皿ペヌゞを取埗し、解析したす。
返り倀はparse_edit_diary_previewず同じです。

=head3 @items = $mixi->get_edit_diary_image($url|'id' => $id);

日蚘を線集再投皿ペヌゞを取埗し、解析したす。
返り倀はparse_edit_diary_imageず同じです。

=head3 @items = $mixi->get_edit_diary_confirm('id' => $id, 'diary_title' => $title, 'diary_body' => $body [, 'photo1' => $path_to_photo1] [, 'photo2' => $path_to_photo2] [, 'photo3' => $path_to_photo3]);

日蚘を線集再投皿したす。
返り倀はparse_edit_diary_confirmず同じです。

=head3 @items = $mixi->get_send_message_preview('id' => $id, 'subject' => $subject, 'body' => $body);

$idのナヌザヌ宛のメッセヌゞ送信ペヌゞに匕数のデヌタを送信し、プレビュヌペヌゞを取埗しお解析したす。
返り倀はparse_send_message_previewず同じです。

=head3 @items = $mixi->get_send_message_confirm('id' => $id, 'subject' => $subject, 'body' => $body [, 'post_key' => $key]);

$idのナヌザヌ宛のメッセヌゞを送信したす。
返り倀はparse_send_message_confirmず同じです。

=head2 Convert URL

URLを絶察URLに倉換するメ゜ッドです。

=head3 $url = $mixi->absolute_url($url [, $base])

$baseをベヌスURLずしお、絶察URLを返したす。
$baseが指定されなかった時は、mixiのトップペヌゞ0.13版では"http://mixi.jp/"をベヌスにしたす。
URLの代わりに'login'、'show_logs'などの'.pl'を省いたファむル名を指定しおも構いたせん。

=head3 $url = $mixi->absolute_linked_url($url)

最埌にgetたたはpostメ゜ッドで取埗したペヌゞのURLをベヌスURLずしお、絶察URLを返したす。
URLの代わりに'login'、'show_logs'などの'.pl'を省いたファむル名を指定しおも構いたせん。

=head3 $url = $mixi->query_sorted_url($url)

URLのク゚リ郚分"?"ã‹ã‚‰åŸŒã‚ïŒ‰ã‚’ã‚­ãƒŒã®æ˜‡é †ã§äžŠã¹æ›¿ãˆãŸã™ã€‚
たた、倀の空癜が"%20"に倉換されおいるずころがあれば+に眮換したす。
結果ずしお、同じク゚リå†
容であれば同じURLに曞き盎されたす。

このメ゜ッドは詊隓甚のå†
郚メ゜ッドで䜿甚するために蚭けられたしたが、URLをキヌずしたキャッシュなどをする際には有甚でしょう。

=head2 Cookies

Cookieの保存や読蟌を行うためのメ゜ッドです。

=head3 $mixi->enable_cookies($cookie_file)

cookieを有効にしたす。
これはログむンlogin、Cookieの読み蟌みload_cookiesなどの際に自動的に行われるので、通垞は明瀺的に行うå¿
芁はありたせん。
ログむンなどにå
ˆç«‹ã£ãŠã€Cookieを操䜜したい時などのために甚意されおいたす。

返り倀はオブゞェクト自身です。

=head3 $mixi->save_cookies($cookie_file)

cookieのå†
容を指定されたファむルに保存したす。
成功時には1、倱敗時には0を返したす。

=head3 $mixi->load_cookies($cookie_file)

指定されたファむルからCookieデヌタを読み蟌みたす。
成功時には1、倱敗時には0を返したす。

=head2 Internal methods

以䞋はWWW::Mixiのå†
郚メ゜ッドです。

基本的にはWWW::Mixiの各メ゜ッドからのみ䜿甚されるこずを前提ずしおおり、埌のバヌゞョンでは仕様が倉曎されたりメ゜ッドが廃止されるかもしれたせん。
できるだけ利甚しない方が良いず思いたす。

=head3 $mixi->log

ログの出力などを行うメ゜ッドで、å†
郚で利甚されたす。
デフォルトでは、callback_logメ゜ッドを呌び出したす。

=head3 $mixi->dumper_log

匕数のダンプをログずしお出力たたは保持するメ゜ッドで、å†
郚で利甚されたす。
実際の出力には、logメ゜ッドを䜿甚したす。

=head3 $mixi->abort

゚ラヌ時のabort凊理を行うメ゜ッドで、å†
郚で利甚されたす。
デフォルトでは、callback_abortメ゜ッドを呌び出したす。

=head3 $mixi->callback_log

匕数をログずしおシフトJISに倉換し、暙準出力に出力したす。
たた、ログに゚ラヌメッセヌゞが含たれおいれば、abortメ゜ッドを呌び出したす。
これはlogメ゜ッドのデフォルトの実è£
で、å†
郚で利甚されたす。

これ以倖のログ凊理をしたいずきには、コンストラクト時に

 $mixi = WWW::Mixi->new($mail, $pass, -log => \&my_callback_log);

のようにしお、代わりのログ出力メ゜ッドを定矩しおやっおください。

=head3 $mixi->callback_abort

dieを実行したす。
これはabortメ゜ッドのデフォルトの実è£
で、å†
郚で利甚されたす。

=head3 $str = $mixi->rewrite

デヌタ解析時のテキスト倀の凊理を行うメ゜ッドです。
デフォルトでは、callback_rewriteメ゜ッドを呌び出したす。

=head3 $str = $mixi->callback_rewrite($str);

HTMLタグの削陀、HTML゚スケヌプの解陀アン゚スケヌプを行いたす。
ほずんどのHTMLタグは単に削陀されたすが、<blockquote>タグだけは、å†
郚を'> 'でむンデントしたす。
これはrewriteメ゜ッドのデフォルトの実è£
で、å†
郚で利甚されたす。

=head3 $str = $mixi->escape($str);

HTML゚スケヌプした文字列を返したす。

=head3 $str = $mixi->unescape($str);

HTMLアン゚スケヌプした文字列を返したす。

=head3 $str = $mixi->remove_tag($str);

タグを削陀した文字列を返したす。
HTMLに限らず、<>のほずんどを削陀する事に泚意しおください。
通垞は、unescapeの前に実行されるものです。

=head3 $str = $mixi->remove_diary_tag($str);

日蚘に䜿われおいるものず思われるタグを削陀したす。
新着日蚘䞭に混å
¥ã™ã‚‹ã€ã‚šã‚¹ã‚±ãƒŒãƒ—された日蚘甚のタグなどを取り陀くのに䜿甚するこずができたす。

ã‚¿ã‚°ãŒé€”äž­ã§åˆ‡ã‚ŒãŠã„ã‚‹å Žåˆã«ã¯ã€å‰Šé™€ã•ã‚ŒãŸã›ã‚“ã€‚

=head3 $mixi->redirect_ok

リダむレクトの可吊を決めるメ゜ッドで、WWW::Mixiã®å Žåˆã¯åžžã«1を返したす。
぀たり、リダむレクトは垞に自動的に実行されたす。

このメ゜ッドはLWP::RobotUAを介しおLWP::UserAgentから継承したredirect_okメ゜ッドを䞊曞きしおいたす。

=head3 @items = $mixi->get_standard_data($parse_method, $ur_definition [, $url] [, 'refresh']);

get_xxxxメ゜ッドの䞻芁凊理を代替する、暙準的なデヌタ取埗メ゜ッドです。
匕数にはデヌタ解析に䜿うメ゜ッド名parse_xxx、URL定矩、取埗するURL、最新æƒ
å ±ã®(再)取埗フラグを指定したす。
URL、最新æƒ
å ±ã®å–åŸ—ãƒ•ãƒ©ã‚°ã¯çœç•¥å¯èƒœã§ã™ã€‚

URLå®šçŸ©ã«æ–‡å­—åˆ—ã‚’æŒ‡å®šã—ãŸå Žåˆã€ã“ã‚Œã¯ãƒ‡ãƒ•ã‚©ãƒ«ãƒˆURLず芋なされたす。
この時、URLの指定を省略するず、URL定矩で枡されたデフォルトURLを取埗したす。
これは、ク゚リ郚が䞍芁でURLã‚’ã‚¢ãƒ—ãƒªã‚±ãƒŒã‚·ãƒ§ãƒ³åŽã§è‡ªå‹•çš„ã«æŒ‡å®šã—ãŠã‚ˆã„å Žåˆã«æœ‰ç”šã§ã™ã€‚

URLå®šçŸ©ã«æ­£èŠè¡šçŸã‚’æŒ‡å®šã—ãŸå Žåˆã€ã“ã‚Œã¯URLが埓うべきパタヌンず芋なされたす。
この時はURLの指定は省略できたせん。
指定されたURLは、URL定矩で枡されたパタヌンずのマッチが指定され、マッチしない時ぱラヌになりたす。
これは、ク゚リ郚がå¿
é ˆã§ã€URLをナヌザからのå
¥åŠ›ã«é Œã‚‰ãªã‘ã‚Œã°ã„ã‘ãªã„å Žåˆã«æœ‰ç”šã§ã™ã€‚

URLが決定、怜査されるず、あずはデヌタの取埗、指定されたメ゜ッドでの解析が行われ、その結果が返されたす。

=head3 @items = $mixi->parse_standard_history( [$response] );

暙準的な履歎ペヌゞのメむン郚分甚の解析メ゜ッドです。
最近のコメントlist_comment.plのメむン郚、コミュニティ最新曞き蟌みnew_bbs.plのメむン郚、マむミクシィ最新日蚘new_friend_diary.plのメむン郚、マむミクシィ最新アルバムnew_albumのメむン郚、マむミクシィ最新レビュヌnew_review.plのメむン郚、日蚘コメント蚘å
¥å±¥æ­ŽïŒˆnew_commentを解析できたす。

返り倀は、é 
目ごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。

 {
        'subject' => 'こんにちわ。',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18 13:18'
 }

なお、それぞれ専甚のメ゜ッドを甚意しおありたすので、そちらを䜿う方が無難です。
珟圚はこれらのペヌゞをparse_standard_historyで解析できるため、å†
郚ではparse_standard_historyを呌び出しおいるだけですが、将来に぀いおはmixi偎の倉曎があるかも知れたせん。
その時には専甚メ゜ッドでしか解析できなくなり、parse_standard_historyを䜿っおいるず手盎しがå¿
芁になるでしょう。

=head3 $item = $mixi->parse_standard_history_next( [$response] );

暙準的な履歎ペヌゞの次ペヌゞぞのリンクの解析メ゜ッドです。
コミュニティ最新曞き蟌みnew_bbs.plのメむン郚、マむミクシィ最新日蚘new_friend_diary.plのメむン郚を解析できたす。

è¿”ã‚Šå€€ã¯ã€æ¬¡ãƒšãƒŒã‚žãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'link' => 'http://mixi.jp/new_bbs.pl?page=2',
        'subject' => '次を衚瀺'
 }

なお、それぞれ専甚のメ゜ッドを甚意しおありたすので、そちらを䜿う方が無難です。
珟圚はこれらのペヌゞをparse_standard_history_nextで解析できるため、å†
郚ではparse_standard_history_nextを呌び出しおいるだけですが、将来に぀いおはmixi偎の倉曎があるかも知れたせん。
その時には専甚メ゜ッドでしか解析できなくなり、parse_standard_history_nextを䜿っおいるず手盎しがå¿
芁になるでしょう。

=head3 $item = $mixi->parse_standard_history_previous( [$response] );

暙準的な履歎ペヌゞの前ペヌゞぞのリンクの解析メ゜ッドです。
コミュニティ最新曞き蟌みnew_bbs.plのメむン郚、マむミクシィ最新日蚘new_friend_diary.plのメむン郚を解析できたす。

è¿”ã‚Šå€€ã¯ã€å‰ãƒšãƒŒã‚žãŒã‚ã‚‹å Žåˆã¯ä»¥äž‹ã®ã‚ˆã†ãªãƒãƒƒã‚·ãƒ¥ãƒªãƒ•ã‚¡ãƒ¬ãƒ³ã‚¹ã§ã™ã€‚

 {
        'link' => 'http://mixi.jp/new_bbs.pl?page=1',
        'subject' => '前を衚瀺'
 }

なお、それぞれ専甚のメ゜ッドを甚意しおありたすので、そちらを䜿う方が無難です。
珟圚はこれらのペヌゞをparse_standard_history_previousで解析できるため、å†
郚ではparse_standard_history_previousを呌び出しおいるだけですが、将来に぀いおはmixi偎の倉曎があるかも知れたせん。
その時には専甚メ゜ッドでしか解析できなくなり、parse_standard_history_previousを䜿っおいるず手盎しがå¿
芁になるでしょう。

=head3 @items = $mixi->parse_standard_form( [$response] );

暙準的なプレビュヌペヌゞ甚のフォヌム解析メ゜ッドです。
ペヌゞå†
のフォヌムを抜出し、formタグのactionアトリビュヌトで指定されおいるURL、inputタグのアトリビュヌトで指定されおいるnameずvalueのペア、textareタグのnameずå†
容のペアを解析できたす。
返り倀は、フォヌムごずに以䞋のようなハッシュリファレンスにしたもののé
åˆ—です。
__action__以倖のキヌは解析するフォヌムごずに異なるこずに泚意しおください。

 {
        '__action__' => 'http://mixi.jp/add_diary.pl',
        'submit' => 'confirm',
        'diary_title' => '今日の日蚘',
        'diary_body' => '今日は朝から晩だった。生たれたばかりの...',
        'orig_size' => 1,
        'packed' => 'xxxxxxx_xxx_xxxx',
        'post_key' => 'xxxxxxx_xxx',
        'link' => 'http://mixi.jp/view_diary.pl?id=xxxxxx',
        'name' => '塚本牧生',
        'time' => '2004/08/18 13:18'
 }

=head3 $parsed = $mixi->parse_standard_tag( $tag );

HTMLタグから、タグ名ずアトリビュヌトを解析したす。
基本的には䞀般的なHTMLタグの正芏衚珟で解析する簡易パヌサですが、気が぀いた範囲å†
で、これだず解析できないmixiのHTMLタグの曞き方にあわせおいたす。

返り倀は、$tagがHTMLタグであれば以䞋のようなハッシュリファレンスです。
HTMLã‚¿ã‚°ã§ã¯ãªã„å Žåˆã€ã‚³ãƒ¡ãƒ³ãƒˆã‚¿ã‚°ã®å Žåˆã¯undefになりたす。
ãƒ¡ã‚œãƒƒãƒ‰ã®æ€§æ ŒäžŠã€URLの絶察パス化や、文字列のサニタむズなどは行われおいない状æ
‹ã§è¿”されるこずに泚意しおください。

 {
        'tag' => 'image',
        'attr' => {
                'src' => 'http://img1.mixi.jp/xxxx.jpg',
                'alt' => '今日のPhoto&amp;Life'
        }
 }

=head3 $url = $mixi->parse_standard_anchor( $tag );

アンカヌタグAタグから、URLを解析したす。
返り倀は、$tagがURLを抜出できればその文字列、HTMLã‚¿ã‚°ã§ã¯ãªã„å Žåˆã€URLã‚’æŠœå‡ºã§ããªã„å Žåˆã¯undefになりたす。
ãƒ¡ã‚œãƒƒãƒ‰ã®æ€§æ ŒäžŠã€URLの絶察パス化や、文字列のサニタむズなどは行われおいない状æ
‹ã§è¿”されるこずに泚意しおください。

なお、mixiのå
žåž‹çš„なアンカヌずしお、onClickでのJavaScript凊理でMM_openBrWindowメ゜ッドにURLを枡しおいるケヌス、同じくwindow.opener.location.hrefでURLを指定しおいるケヌス、䞀般的なhrefアトリビュヌトにURLがå
¥ã‚Œã‚‰ã‚ŒãŠã„るケヌスがありたす。
ã“ã®ãƒ¡ã‚œãƒƒãƒ‰ã¯ã€ã“ã“ã§äžŠã’ãŸé †ç•ªã§URLを取埗しようずしたす。

=head3 $url = $mixi->set_response( $url [ => 'refresh'] )

responseメ゜ッドの返り倀を、$url取埗時のデヌタになるようにセットしたす。
これにあわせお、各解析メ゜ッドのデフォルトの解析察象デヌタも$urlのものになりたす。

デフォルトでは、$urlが最埌にgetたたはpostで取埗したURLず異なる時だけ、$urlをgetで取埗したす。
ã“ã‚Œã«ã‚ˆã‚Šã€äžèŠãªå†å–åŸ—ã®è² è·ãšæ™‚é–“ã‚’ã‹ã‘ãªã„ã‚ˆã†ã«ã—ãŠã„ãŸã™ã€‚
ã“ã®å Žåˆã§ã‚‚ãƒ‡ãƒŒã‚¿ã‚’å†å–åŸ—ã—ã€æœ€æ–°ã®ãƒ‡ãƒŒã‚¿ã«ã—ãŸã„æ™‚ã«ã¯'refresh'を指定しおください。

=head3 $response = $mixi->post_add_diary('submit' => $action, 'diary_title' => $title, 'diary_body' => $body [, 'post_key' => $key] [, 'photo1' => $path_to_photo1, 'photo2' => $path_to_photo2, 'photo3' => $path_to_photo3] [, 'orig_size' => 1]] [, 'packed' => $packed_value] [, 'id' => $self_id] [, 'news_id' => $news_id]);

日蚘䜜成ペヌゞに匕数のデヌタを送信したす。
返り倀は送信時のHTTP::Responseオブゞェクトです。

$self_idには自身のmixiナヌザヌIDを指定したす。
ニュヌスに関連した日蚘を投皿する時は、$news_idを指定したす。

確認画面を取埗する時は、$actionに"main"を指定したす。
画像を添付する時はphoto13に画像のファむルパスを指定し、「そのたたのサむズで送信」する時には、orig_size => 1も指定したす。

実際に投皿する時には、$actionに"confirm"を指定したす。
たた、$post_keyに確認画面から取埗したpost_keyフィヌルドの倀を指定したす。
画像を添付する時は$packed_valueに確認画面から取埗したpackedフィヌルドの倀を指定したす。
この時、packedが画像指定の代わりになっおいるので、photo13は䞍芁です。

=head3 $response = $mixi->post_edit_diary('submit' => $action, 'diary_id' => $id, 'diary_title' => $title, 'diary_body' => $body, 'photo1' => $path_to_photo1, 'photo2' => $path_to_photo2, 'photo3' => $path_to_photo3, 'form_date' => $form_date);

日蚘線集ペヌゞに匕数のデヌタを送信したす。
返り倀は送信時のHTTP::Responseオブゞェクトです。

アクションには、線集する時には"main"を指定したす。
写真13には、ファむルパスを指定したす。

=head3 $response = $mixi->post_delete_diary('submit' => $action, 'diary_id' => $id, 'post_key' => $key);

日蚘削陀ペヌゞに匕数のデヌタを送信したす。
返り倀は送信時のHTTP::Responseオブゞェクトです。

アクションには、確認画面を取埗する時は"main"、実際に投皿する時には"confirm"を指定したす。

=head3 $response = $mixi->post_send_message('id' => $id, 'subject' => $subject, 'body' => $body, 'post_key' => $key);

メッセヌゞ送信ペヌゞに匕数のデヌタを送信したす。
返り倀は送信時のHTTP::Responseオブゞェクトです。

=head3 $time = $mixi->convert_login_time($time);

「お気にå
¥ã‚Šã€ã«è¡šç€ºã•ã‚Œã‚‹ã€Œ45分以å†
」などの蚘述を時刻に盎したす。

=head2 Testing method

以䞋はWWW::Mixiの詊隓甚のメ゜ッドです。

=head3 perl -MWWW::Mixi -e "WWW::Mixi::test('email', 'password' [, 'logfile'])"

WWW::Mixiの各機胜を詊隓するためのメ゜ッドです。

0.13版ではコンストラクタ、ログむン、デヌタの取埗、Cookieの保存が詊隓されたす。
これらはå†
郚でURLの倉換、ログむン状況の取埗、ペヌゞ取埗getずpost、解析などのメ゜ッドを䜿甚しおいたす。

email、passwordはmixiにログむンできるものを指定しおください。
ログファむルは解析結果を出力するためのものです。
未指定時は'LWP-Mixi-x.xx-test.log'が䜿甚されたす。

=head1 RESPONSE CODE

いく぀かのケヌスでは、mixiがレスポンスコヌド"200"ãªã©ã‚’è¿”ã™å Žåˆã§ã‚‚ã€å®Ÿéš›ã®ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ã®å†
容からWWW::Mixiがレスポンスコヌドずレスポンスメッセヌゞを眮き換えたす。
これにより、WWW::Mixiはナヌザヌのリク゚ストが"実質的に"æˆåŠŸã—ãŸå Žåˆã«ã®ã¿is_successが真になり、"実質的に"å€±æ•—ã—ãŸå Žåˆã«ã¯åœã«ãªã‚‹ïŒˆis_errorが真になるように振舞いたす。

ここで䜿甚されるレスポンスコヌドは䞀般的なものなので、䟋えばレスポンスコヌド"400"は本圓にmixiからBad RequestãŒè¿”ã•ã‚ŒãŸå Žåˆã‚‚ã‚ã‚ŠãŸã™ã—ã€ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ãŒã€Œãƒ‡ãƒŒã‚¿ãŒã‚ã‚ŠãŸã›ã‚“ã€ãšã„ã†ã‚‚ã®ã§ã‚ã‚‹å Žåˆã‚‚ã‚ã‚ŠãŸã™ã€‚
レスポンスメッセヌゞはWWW::Mixiが独自のものをセットしたすので、こちらで区別しおください。

=over 4

=item "400"

以䞋のケヌスで、レスポンスコヌドは400に眮き換えられたす。

=over 8

=item No Data

䟋えばidを指定せずにview_diary.plにアクセスした時などに、「デヌタはありたせん。」ずいう䞀蚀だけのペヌゞが返っおきたす。
ã»ãšã‚“ã©ã®ã‚±ãƒŒã‚¹ã§ã¯ã€åŽŸå› ã¯æŒ‡å®šã™ã¹ãã‚¯ã‚šãƒªé 
目が指定されおいないケヌスなので、WWW::Mixiはこのレスポンスを「400 Bad Request」の䞀皮ずみなしたす。

=item Invalid Form Data (゚ラヌメッセヌゞ)

日蚘投皿で衚題が指定されおいない時などに、プレビュヌ画面に゚ラヌメッセヌゞが衚瀺されたす。
parse__previewメ゜ッドで投皿プレビュヌを解析時、WWW::Mixiはこのレスポンスを「400 Bad Request」の䞀皮ずみなしたす。

他のケヌスず違い、parse__previewメ゜ッドで解析を行うたではレスポンスコヌドずレスポンスメッセヌゞの眮き換えが行われない点に泚意しおください。
request実斜盎埌は、通垞はレスポンスコヌドは200などでしょう。

=back

Invalid Form Dataに続く゚ラヌメッセヌゞはmixiが返したもので、通垞は日本語文字コヌドはEUCであるこずに泚意しおください。
このメッセヌゞをそのたた出力する際には、䟋えば以䞋のようにしお文字コヌドを適切に倉換しおやるべきです。

 use Jcode;
 use WWW::Mixi
 my $mixi = WWW::Mixi->new('your@email', 'yourpassword');
 my $res = $mixi->login;
 if ($res->code == 401) {
   print jcode($res->message)->sjis, "\n";
   ...
 }

=item "401"

以䞋のケヌスで、レスポンスコヌドは401に眮き換えられたす。
珟圚のずころ、mixiはベヌシック認蚌などを求めないため、゚ラヌコヌド401はすべおこのケヌスずみなしお問題ないでしょう。

=over 8

=item Login Required

ログむンフォヌムが衚瀺されおいたす。
おそらく未ログむンか、別のブラりザなどでログアりトしたため、再ログむンがå¿
芁な状æ
‹ã§ã™ã€‚

=item Login Failed (゚ラヌメッセヌゞ)

ログむンフォヌムずずもに、゚ラヌメッセヌゞが衚瀺されおいたす。
おそらくログむンに倱敗した状æ
‹ã§ã€ã‚šãƒ©ãƒŒãƒ¡ãƒƒã‚»ãƒŒã‚žã‹ã‚‰ã‚ˆã‚Šæ­£ç¢ºãªçŠ¶æ³ã‚’刀断しおください。

=back

ログむン倱敗時の゚ラヌメッセヌゞはmixiが返したもので、通垞は日本語文字コヌドはEUCであるこずに泚意しおください。
このメッセヌゞをそのたた出力する際には、文字コヌドを適切に倉換しおやるべきです。

=item "403"

以䞋のケヌスで、レスポンスコヌドは403に眮き換えられたす。

=over 8

=item Closed content

「アクセスできたせん。」ずいう䞀蚀だけのペヌゞが返っおきたす。
おそらく、å
¬é–‹ç¯„囲が「友人たで」など、アクセスè€
ãŒé–²èŠ§ã§ããªã„ã‚³ãƒ³ãƒ†ãƒ³ãƒ„ïŒˆæ—¥èš˜ãªã©ïŒ‰ã«ã‚¢ã‚¯ã‚»ã‚¹ã—ãŸå Žåˆã§ã™ã€‚

=back

=item "503"

以䞋のケヌスで、レスポンスコヌドは503に眮き換えられたす。

=over 8

=item Too frequently requests

ã€Œé–“éš”ã‚’ç©ºã‘ãªã„é€£ç¶šçš„ãªãƒšãƒŒã‚žã®é·ç§»ãƒ»æ›Žæ–°ã‚’é »ç¹ã«ãŠã“ãªã‚ã‚ŒãŠã„ã‚‹ãŸã‚...」ずいう䞀文だけのペヌゞが返っおきたす。
おそらく、Mixi偎で蚭定されおいるアクセス制限間隔より短い間隔でアクセスしたこずにより、アクセスが拒吊されおいたす。
この状況は、数分から数十分埌に解陀されるようです。

通垞、WWW::Mixiは十分に長いむンタヌバルを眮いおアクセスするため、この問題は起こらないはずです。
明瀺的にアクセス間隔を短くしたか、倚重に動かしおいるなどによるこずが考えられたす。
WWW::Mixiはmixiã«å€šå€§ãªè² è·ã‚’ã‹ã‘ãªã„ãªã©ã®è€ƒæ
®ã‚’前提にé
åžƒãƒ»å
¬é–‹ã‚’黙認されおいたすので、この゚ラヌが出るようであればツヌルの蚭蚈を芋盎すこずを匷く掚奚したす。

=back

=back

=head1 SEE ALSO

L<LWP::UserAgent>, L<WWW::RobotUA>, L<HTTP::Request::Common>

=head1 AUTHORS

WWW::Mixi is written by TSUKAMOTO Makio <tsukamoto@gmail.com>

Some bug fixes submitted by Topia (http://clovery.jp/), shino (http://www.freedomcat.com/), makamaka (http://www.donzoko.net/), あっしã‚
, slash/onigawara (http://www.okoshi.org/), Mami Komura (http://www.warehouse56.com/).
get_ and post_add_diary, get_ and post_delete_diary, parse_list_diary, parse_list_diary_monthly_menu and parse_new_diary contributed by DonaDona (http://hsj.jp/).
get_ and parse_view_diary contributed by shino (http://www.freedomcat.com/).
get_ and parse_list_outbox contributed by AsO (http://www.bx.sakura.ne.jp/~clan/rn/cgi-bin/index.cgi).
get_ and post_send_message contributed by noname (http://untitled.rootkit.jp/diary/).

=head1 COPYRIGHT

Copyright 2004-2005 TSUKAMOTO Makio.

This library is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.