FC2ミニブログPIYO

API説明

APIとは、他のプログラムでもPIYOにアクセスすることができる外部プログラムインターフェイスです。
当サービスに影響のある過剰なアクセスについては制限させていただく可能性がありますので予めご了承くださいます様、お願い申し上げます。
また、当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 : %エラーメッセージ%

 

2 : comment

指定したメッセージNOに付随するコメントと親メッセージを取得する。(最大30件)
コメントがない場合は、親メッセージのみ。
削除されているメッセージ、友達指定送信は除外

[URL] :

//piyo.fc2.com/contents/api/?mode=comment&key=__APIKEY__&no=__MESSAGENO__&limit=__%d__&page=__%d__

 

[フォーマット] :

xml

 

[メソッド] :

GET

 

[パラメータ] :

  • mode : comment (必須)
  • key : 取得したAPIKEY (必須)
  • no : メッセージNO (必須)
  • limit : データ取得件数。省略すると30件 (オプション)
  • page : ページ番号 (オプション)

 

[取得データ] :

親メッセージ

  • piyoid : PIYOID
  • nickname : ニックネーム
  • profimg : メッセージのプロフィール画像
  • no : メッセージNO
  • body :　メッセージ本文
  • date : 投稿日時
  • rescount : コメント数
  • tmpfile : 添付画像
  • tmpmovurl : 添付動画のURL

コメント

  • piyoid : PIYOID
  • nickname : ニックネーム
  • profimg : メッセージのプロフィール画像
  • no : コメントNO
  • body :　コメント本文
  • date : 投稿日時
※エラーした場合 : 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ならエラーメッセージ