API説明
APIとは、他のプログラムでもPIYOにアクセスすることができる外部プログラムインターフェイスです。
当サービスに影響のある過剰なアクセスについては制限させていただく可能性がありますので予めご了承くださいます様、お願い申し上げます。
また、当APIは現在開発途中でありますので予告なく変更する恐れがあります。
- メッセージ関連のAPI
- ユーザ情報関連のAPI
- メッセージ送信のAPI
1 : public
-
広場の最新の発言を取得する。(最大30件)
[URL] :
//piyo.fc2.com/contents/api/?mode=public&key=__APIKEY__&limit=__%d__&page=__%d__
[フォーマット] :
xml
[メソッド] :
GET
[パラメータ] :
- mode : public (必須)
- key : 取得したAPIKEY (必須)
- limit : データ取得件数。省略すると30件 (オプション)
- page : ページ番号 (オプション)
[取得データ] :
- piyoid : PIYOID
- nickname : ニックネーム
- profimg : メッセージのプロフィール画像
- no : メッセージNO
- body : メッセージ本文
- date : 投稿日時
- rescount : コメント数
- tmpfile : 添付画像
- tmpmovurl : 添付動画のURL
※エラーした場合 : error : %エラーメッセージ%
2 : user
-
指定したPIYOIDのメッセージを取得する。指定送信は除外。(最大30件)
[URL] :
//piyo.fc2.com/contents/api/?mode=user&key=__APIKEY__&userid=__指定する人のPIYOID__&limit=__%d__&page=__%d__
[フォーマット] :
xml
[メソッド] :
GET
[パラメータ] :
- mode : user (必須)
- key : 取得したAPIKEY (必須)
- userid : 指定する人のPIYOID (省略すると自分の発言を取得) (オプション)
- limit : データ取得件数。省略すると30件 (オプション)
- page : ページ番号 (オプション)
[取得データ] :
- piyoid : PIYOID
- nickname : ニックネーム
- profimg : メッセージのプロフィール画像
- no : メッセージNO
- body : メッセージ本文
- date : 投稿日時
- rescount : コメント数
- tmpfile : 添付画像
- tmpmovurl : 添付動画のURL
※エラーした場合 : error : %エラーメッセージ%
4 : status
-
指定したPIYOIDのプロフィール、その友達のプロフィールを取得する。(最大30件)
[URL] :
//piyo.fc2.com/contents/api/?mode=status&key=__APIKEY__&userid=__取得する人のPIYOID__&option=f&limit=__%d__&page=__%d__
[フォーマット] :
xml
[メソッド] :
GET
[パラメータ] :
- mode : status (必須)
- key : 取得したAPIKEY (必須)
- userid : 取得したい人のPIYOID。省略で自分のプロフィールを取得 (オプション)
- option : f あれば友達のプロフィールも取得 (オプション)
- limit : データ取得件数。省略すると30件 (オプション)
- page : ページ番号 (オプション)
[取得データ] :
- piyoid : PIYOID
- nickname : ニックネーム
- profimg : メッセージのプロフィール画像
- blog_title : ミニブログのタイトル
- introduction : 自己紹介文
- blog_url : ブログのURL
- homepage_url : ホームページのURL
- friends_count : ピヨともの人数
- mes_count : 書き込み回数
- com_count : コメント回数
※エラーした場合 : error : %エラーメッセージ%
5 : send
-
ひろばにメッセージを送信する
[URL] :
//piyo.fc2.com/contents/api/?mode=send&key=__APIKEY__
[フォーマット] :
xml
[メソッド] :
POST
[パラメータ] :
- mode : send (必須)
- key : 取得したAPIKEY(必須)
- pid : 自分のPIYOID(必須)
- content : 投稿内容。エンコードする。255文字以内。UTF-8で送信。(必須)
[取得データ] :
- result : 0 成功 1 失敗
- message : resultが0なら投稿内容、1ならエラーメッセージ