kishi-r.com

mixiアプリで「Restful API for PC」を試してみた

opensocial posted by (C)kishir

mixiアプリで「Restful API for PC」を試してみたので、メモ用に残しておく。

1. APIを使用するため、「Consumer key」と「Consumer Secret」を発行する。

• 発行するには、mixiアプリ管理画面から可能
• 各アプリ画面（http://mixi.jp/view_appli.pl?id=[アプリID]）の「設定変更」リンクから、アプリ管理画面へ
• まだ「Consumer key」と「Consumer Secret」を発行していない場合は、一度「同意する」にチェックを行い「設定を変更する」をクリックする必要がある
• 設定を変更すると、「アプリの説明」の上部に「Consumer Key」「Consumer Secret」という項目が追加される（変更などは出来ないので、テキストでの表示）

2. APIを使用するためにはアクセスに関して制限あり

• APIを使用するにあたり、誰の権限でアクセスを行うかを指定することが必要
• 誰の権限かを指定するには「対象ユーザのID」を使用
• ここで注意するのが「対象ユーザーID」は「一定時間内にWebブラウザで対象のmixiアプリを起動したユーザ」のIDのみが指定可能

3. 現在（2010.01.25）mixiアプリで利用可能なAPI

• Person & Friends API

  これだけなので、「ユーザのプロフィールやマイミクに関する情報」しか取得出来ない

  # アプリケーション毎で保持している「永続化データ（AppData）」などは不可

  つまり取得出来るデータは、 JavaScriptAPIで「プロフィール情報を取り出す時」の

var req = opensocial.newDataRequest();
req.add(req.newFetchPersonRequest(opensocial.IdSpec.PersonId.VIEWER), "viewer");
req.send(function(data) {
   if (data.hadError()) {
       var msg = data.getErrorMessage();
       // エラー発生時の処理
   } else {
       // 取得結果に対する処理
       var item = data.get("viewer");
       var viewer = item.getData();
       var id = viewer.getId();
       var nickname = viewer.getDisplayName();
       var thumbnailUrl = viewer.getField(opensocial.Person.Field.THUMBNAIL_URL);
   }
});

と同じですね。

4. 取得するためのURLパターン

• 取得時のURL（バージョンは0.8）：http://api.mixi-platform.com/os/0.8/

• 各パターンは下記

  • /people/{guid}/@all
  • /people/{guid}/@friends
  • /people/{guid}/@self
  • /people/@me/@self

  注意1：{guid} とはmixiのユーザーIDとなり、指定方法は「mixi.jp:1234」もしくは、「1234」と指定する。 注意2：現在（2010.1.26）mixi上ではpeopleで取得出来るデータのみが対応可（永続化データ取得の「appdata」で指定するとエラー（401）になりました。）

  例： http://api.mixi-platform.com/os/0.8/people/1234/@all

5. 取得時のフォーマット

• JSON
• XML（atom + xml）

指定方法は、

?format=json

例：http://api.mixi-platform.com/os/0.8/people/1234/@all?format=json

6. 取得可能なフィールド一覧

   基本情報

   • ニックネーム（nickname）
   • プロフィールURL（profileUrl）
   • プロフィール画像URL（thumbnailUrl）
   • アプリ利用状態（hasApp）
   • 血液型 ※A, AB, B, Oのいずれか（bloodType）

   プロフィール情報

   • 現住所（addresses）
   • 生年月日（birthday）
   • 性別（gender）

   基本情報以外の項目を取得する場合は、以下のように fields パラメータに項目名をカンマ区切りで指定

?format=json&fields=birthday,gender

  アプリをインストールしているマイミク一覧を取得する場合は下記のように指定

?format=json&filterBy=hasApp

7. 実際にデータ取得を試してみる

Google Codeやmixiにも記載されているPHPのコードを元に、

簡単に返すクラスを作って使ってみた。

ソースは下記

<?php

require_once('OAuth.php');

define(_CONSUMER_KEY_, 'ここに「ConsumerKey」を記述');
define(_CONSUMER_SECRET_, 'ここに「ConsumerSecret」を記述');

class TestRestfulAPI
{
   private $_base_feed  = NULL;
   private $_consumer  = NULL;
   private $_viewer_id   = NULL;

   public function __construct($viewer_id=NULL)
   {
       if (!$viewer_id && is_null($viewer_id)) return false;
       $this->_viewer_id  = $viewer_id;
       $this->_base_feed = sprintf('http://api.mixi-platform.com/os/0.8/people/%s/@self', $this->_viewer_id);
   }

   public function get()
   {
       try{
           $params = array('xoauth_requestor_id' => $this->_viewer_id);
           $this->_consumer = new OAuthConsumer(_CONSUMER_KEY_, _CONSUMER_SECRET_, NULL);
           $request = OAuthRequest::from_consumer_and_token(
               $this->_consumer, NULL, 'GET', $this->_base_feed, $params);

           // Sign the constructed OAuth request using HMAC-SHA1
           $request->sign_request(new OAuthSignatureMethod_HMAC_SHA1(),
                                   $this->_consumer, NULL);

           // Make signed OAuth request to the Contacts API server
           $url  = $this->_base_feed . '?' . $this->implode_assoc('=', '&', $params);
           $curl = curl_init($url);
           curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
           curl_setopt($curl, CURLOPT_FAILONERROR, false);
           curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
           curl_setopt($curl, CURLOPT_ENCODING, 'gzip');
           $auth_header = $request->to_header();
           if ($auth_header) {
               curl_setopt($curl, CURLOPT_HTTPHEADER, array($auth_header));
           }

           $response = curl_exec($curl);
           if (!$response) {
               $response = curl_error($curl);
           }
           curl_close($curl);
       } catch (Exception $e) {
           //var_dump($e);
           return false;
       }
       return $response;
   }

   function implode_assoc($inner_glue, $outer_glue, $array, $skip_empty=false)
   {
       $output=array();
       foreach ($array as $key => $item) {
           if (!$skip_empty || $item) {
               $output[] = $key. $inner_glue. urlencode($item);
           }
       }
       return implode($outer_glue, $output);
   }
}

$viewer_id  = $_POST('viewer_id');
$api             = new TestRestfulAPI($viewer_id);
$data           = $api->get();
print($data);

こいつをjsからmakeRequest()関数を使って動作させれば、

viewerの情報が取得出来る。

後々、peopleの部分を永続化データを取得するために「appdata」などに

置き換えるように変更したり、「@self」部分を「@all」などに変更出来るように

クラスを書き換えてやれば、ひとまずこれだけでRestful API対応は出来そう。

[2010-2-4 追記]

== 利用可能なクエリーパラメータの指定方法 ==

OpenSocialの本家サイトなどみれば解りそうだが、念のためメモメモ

上記のコードでURLを指定している箇所があるが、そこに直接クエリーパラメータを付与すると、

401でエラーになってしまう。

例：

<?php

$this->_base_feed = sprintf('http://api.mixi-platform.com/os/0.8/people/%s/@self', $this->_viewer_id);

この部分を「マイミクでかつアプリをインストールしているユーザーのみ1000件取得する」という指定で取得するために、

<?php

$this->_base_feed = sprintf('http://api.mixi-platform.com/os/0.8/people/%s/@friends?filterBy=hasApp&count=1000', $this->_viewer_id);

とやるとエラー

解決方法は、下記の部分の配列にパラメータを指定する

<?php

$params = array('xoauth_requestor_id' => $this->_viewer_id); // この部分
$this->_consumer = new OAuthConsumer(_CONSUMER_KEY_, _CONSUMER_SECRET_, NULL);
$request = OAuthRequest::from_consumer_and_token(
    $this->_consumer, NULL, 'GET', $this->_base_feed, $params);

上記にある「// この部分」の箇所を下記ように記述する

<?php

$params = array(
    'xoauth_requestor_id' => $this->_viewer_id,
    'filterBy'            => 'hasApp',
    'count'               => 1000
);

これで正常に取得する事が出来る。

MT3.3からWordPress2.5への移行時に行った事

メモ代わりに。

移行する際に気になるのがパーマリンクの保持。

ようは以前と同じURLで移行しないとﾀﾞﾒだよねって事で、

色々と調べてみたが最新の2.5対応が無かったorz

でもやる事としては、同じだよね。

1. パーマリンクの保持


2. タグの保持


3. RSSフィードのURLの保持


4. トラックバックとコメントの保持

1. WordPressのインストール


2. WordPressのパーマリンクの設定


3. MovableTypeへのパッチ


4. WordPressへのパッチ


5. MovableTypeからデータをエクスポート


6. WordPressへデータをインポート

} else if ( 0 === strpos($line, "PERMALINK:") ) {
$value = trim( substr($line, strlen("PERMALINK:")) );
$tmpvalue = strrchr($value,"/");<br />
$post->post_name = substr($tmpvalue, 0, strpos($tmpvalue, "."));

AUTHOR: kishi-r
TITLE: 最近読む著者たち
STATUS: Publish
ALLOW COMMENTS: 1
CONVERT BREAKS: __default__
ALLOW PINGS: 1
PRIMARY CATEGORY: Book
CATEGORY: Book

DATE: 12/04/2006 09:49:02 PM
PERMALINK: http://kishi-r.com/2006/12/post_4.html
TAGS: book
ID: 8
-----
BODY:
・石田衣良
ご存知、池袋ウエストゲートパークを書いている人
他にも結構面白い本が沢山ある。
例えば、「４TEEN」「うつくしい子ども」「エンジェル」「ブルータワー」などがおもしろかった。
一番ｸﾞっときたのは「ブルータワー」です。
簡単に説明すると内容はＳＦなんですが、
現代と自分の頭の中の世界を行き来し、世界を救うという話です。
それぞれ登場するｷｬﾗが個性的でおもしろい。
映画化すると結構人気がでるかもしれない。
他の作品も是非読んで欲しい。

・・・・・・・・以下続きます。

PHPってそんなに・・・

最近PHPをディスるってのが、
はやっているみたいｗ

でもディスるってのも久々に聞いたから、
ウケるｗ

90年代のHIPHOPでは結構聞いたけどなぁ～。
ICE CUBEとCypress Hillとかがディスってるレコードも
持ってるし。

でも向こうでは本当に殺されるから怖い。
2PacとかNotorious BIGとかもそうだもんなぁ～。
好きだったのに・・・。

まぁ～ネタだから、
そんなことが起きないように願ってます。

自分自身PHPからプログラムを始めたんですが、
PHPには感謝してます。
だってそれがきっかけだから。
一番大事ですよね。

今年初勉強会は「第３０回PHP勉強会」でした

最近自分のサーバのインストール大会ばっかで、
コードなんかは会社の作業でしか書いてない。

そんな中、
今年初めての勉強会「第３０回PHP勉強会」に行ってきた。

メインとなった話は

４→５への移行の話でした。
PHPマニュアルにも記載されているらしいが、
情報量はかなり少ないらしい。

弊社でもその話が出ていて、
マンモス本参考の勉強会がありました。

色々と聞いていて疑問に思った事は、

・フレームワークが５に対応してなかったらどうするの？
・E_STRICTを使ってエラーを無くすのは、時間が掛かるのでは？
・&=をGrepしてもどれを修正するのか精査するのに、時間が掛かるのでは？

などを感じました。
もうちょっと移行するのに簡単な方法は無いのかな？

無いか・・・？。

後は、
懇談会でrhacoの中の人と色々話しを聞きました。
やはり自分的にはフレームワークというよりこちらの方が使いやすそう。
Djangoっぽい作りが入りやすそうなので、
ちょっと試してみる事にします。
簡単な案件なんかがあったら、
是非業務で使ってみようと本気で考えています。

ipythonのように対話的な事も出来るらしいので、
それもすごい惹かれました。

とりあえずPHPをインストールしないと始まらないので、
インストールしないとな。

発表者の皆様はお疲れさまでした。
名刺交換していただいた方、
どうもありがとうございました。

今回も名刺がかなり増えてうれしかったです。

※ウノウの名刺が変わっていてビックリした。
※rhacoの名刺が出来ていて感動した。それもかなり素敵。

さくらインターネットで「OpenPNE」をインストール

さくらインターネットで
「OpenPNE」をインストールしてみた。

プランは「スタンダード」でインストールした。
ライトプランだとPHPとMySQL使えないとの事です。

参考したサイトは
「OpenPNE.jp ～OpenPNE公式SNS～ 」
http://www.openpne.jp/wiki/OpenPNESetup#section4

「おぢさん日記改」
http://blog.cano-lab.org/archives/academic/openpne/

インストールした「OpenPNE」のバージョンは「2.6.4」

１．ファイルのダウンロード

「OpenPNE.jp ～OpenPNE公式SNS～ 」から最新版をダウンロード
http://sourceforge.net/projects/openpne
「OpenPNE-2.6.4.zip」をダウンロード
※バージョンは、これを書いている時点では「2.6.4」

２．ファイルの解凍

ダウンロードしたファイル「OpenPNE-2.6.4.zip」を
適当に解凍すると「OpenPNE」というフォルダが出来る

３．設定ファイル

解凍して出来たフォルダ「OpenPNE」にある「config.php.sample」
というファイルがある。
これが設定ファイルなので、これを編集する

まず「config.php.sample」を「config.php」にリネームする

次にリネームした「config.php」を編集する
編集するのは下記



まず13行目の
「ユーザー名」

さくらインターネットのユーザ名を入力する

さくらインターネットのサーバパスワード

コントロールパネルにどのデータベースサーバが使えるか表示されているので、
そちらを参考に入力

さくらインターネットはユーザー名と同じなので、データベースの名前にはユーザー名を入力

会員ログイン情報の暗号キー(56バイト以内のASCII文字)
他人に推測されにくい文字列を入力

これは携帯版でメール投稿をする場合に使う

/home/ユーザー名/sns

OpenPNE/setup/sql/install

・install-2.6-create_tables-mysql40.sql

・install-2.6-create_tables-mysql41.sql

・install-2.6-insert_data.sql

・option-2.6-pnebiz-header.sql

・install-2.6-create_tables-mysql40.sql

・install-2.6-insert_data.sql

・option-2.6-pnebiz-header.sql

・install-2.6-create_tables-mysql40.sql

・install-2.6-insert_data.sql

・option-2.6-pnebiz-header.sql

公開用ディレクトリ　：　

public_html


OpenPNE設定ファイルなどのディレクトリ　：
　
bin

lib

var

webapp

webapp_biz

webapp_exr

binディレクトリの中にあるcronファイルのパーミッションも
755になっているかどうか確認しておきましょう。
これを忘れるとお知らせメールとかが飛ばなくなります。

jpGraphをインストール時にハマったこと

jpgraphインストールした後、「さぁ試すぞだ!!!」って時に文字が化けてしまった。

ｲﾛｲﾛと調べた結果下記のようになる。

PHPの内部エンコーディングがEUC-JPの場合、日本語フォントの
設定方法での対処だけでは日本語が化けてしまう。
jpgraph 1.20.5の場合、EUC-JPでないとwarningが発生して表示できないらしい。

gd_image.inc.phpの1349行目あたりに、

// Do special language encoding
   $txt = $this->langconv->Convert($txt,$this->font_family);

   $txt = mb_convert_encoding( $txt, "EUC-JP", "UTF-8"); <-ここを追加

FF_MINCHO =>  array(FS_NORMAL=>MINCHO_TTF_FONT, 
FS_BOLD=>MINCHO_TTF_FONT,
　　　FS_ITALIC=>MINCHO_TTF_FONT, FS_BOLDITALIC=>MINCHO_TTF_FONT ),
FF_PMINCHO => array(FS_NORMAL=>PMINCHO_TTF_FONT, 
FS_BOLD=>PMINCHO_TTF_FONT,
FS_ITALIC=>PMINCHO_TTF_FONT, FS_BOLDITALIC=>PMINCHO_TTF_FONT ),
FF_GOTHIC  => array(FS_NORMAL=>GOTHIC_TTF_FONT, 
FS_BOLD=>GOTHIC_TTF_FONT,
FS_ITALIC=>GOTHIC_TTF_FONT, FS_BOLDITALIC=>GOTHIC_TTF_FONT ),
FF_PGOTHIC => array(FS_NORMAL=>PGOTHIC_TTF_FONT, 
FS_BOLD=>PGOTHIC_TTF_FONT,
FS_ITALIC=>PGOTHIC_TTF_FONT, FS_BOLDITALIC=>PGOTHIC_TTF_FONT ));

phpでGDを使う場合のconfigure

とりあえずメモしておこっと。

忘れちゃうからね・・・。
そういえば、「GD」をインストールする前に「Feetype」「png」「jpeg」「zlib」は
先にインストールしないと「GD」をconfigureしても反映されないんだね・・・。

「Freetype」をインストールせずに「GD」をconfigureしたら

# tar zxvf gd-2.0.28.tar.gz

# cd gd-2.0.28

# ./configure --without-libiconv-prefix


** Configuration summary for gd 2.0.28:


Support for PNG library: yes

Support for JPEG library: yes

Support for Freetype 2.x library: no

Support for Xpm library: yes

Support for pthreads: yes

# tar zxvf gd-2.0.28.tar.gz

# cd gd-2.0.28

# ./configure --without-libiconv-prefix


** Configuration summary for gd 2.0.28:


Support for PNG library: yes

Support for JPEG library: yes

Support for Freetype 2.x library: yes

Support for Xpm library: yes

Support for pthreads: yes

# make

# make install

TrueTypeフォントをレンダリングするライブラリ

1989年にApple社が開発し、同社のMac OS 7.0(当時はSystem 7.0)から搭載している

フォントシステム。

また、同システムで用いられるフォント形式。

Microsoft社に技術供与され、Windows 95からはシステム標準のフォントシステムとして

広く用いられている。

TrueTypeはOSの機能として実装されたアウトラインフォントシステムであるため、

拡大・縮小してもジャギー(ギザギザ)が生じず、解像度によらない精細な出力を画面と

印刷の両方で同じように得られる。

./configure

--with-pgsql=/usr/local/pgsql

--with-mysql=/usr/local/mysql

--enable-track-vars

--with-apxs=/usr/local/apache/bin/apxs

--enable-versioning

--enable-mbstring

--enable-mbregex

--enable-mbstr-enc-trans

--with-gd

--with-freetype-dir=/usr/local/include/freetype2

--with-jpeg-dir=/usr/local/lib

--with-png-dir=/usr/local/lib

--with-zlib-dir=/usr/local/lib

--enable-gd-native-ttf

--enable-gd-jis-conv

--enable-bcmath