README

这个SDK可以让您快速将PIXNET的相关数据整合到您的PHP项目中。详细API信息请参考http://developer.pixnet.pro/

这个开源库允许您将PIXNET集成到您的PHP应用程序中。更多信息请访问http://developer.pixnet.pro/

安装 - 安装#

使用Composer

• 将"pixnet/php-sdk": "@stable"添加到您的composer.json的require部分。
• 执行composer install。

使用 - 使用#

在使用之前，请先至PIXNET开发者注册新的APP。

http://developer.pixnet.pro/#!/apps

申请完成后会得到以下两把钥匙

1. 客户端密钥(client_id)
2. 客户端密钥

并且您需要设置一个注册的回调URL地址

使用Composer

参考以下代码，将必要参数放入SDK中就可以开始使用了

require_once(__DIR__ . '/vendor/autoload.php');

$pixapi = new PixAPI(array(
  'key'  => 'your consumer key',
  'secret' => 'your consumer secret',
  'callback' => 'your registered callback url'
));

不使用Composer

require_once(__DIR__ . '/src/PIXNET/Loader.php');

$pixapi = new PixAPI(array(
  'key'  => 'your consumer key',
  'secret' => 'your consumer secret',
  'callback' => 'your registered callback url'
));

更多示例

更多完整示例在examples文件夹中，请执行examples/index.php，根据步骤进行设置

联系我们

Email: pixnetapi@pixnet.tw Twitter: @pixnetapi

快速查询用法

博客

- 列出部落格資訊 $pixapi->blog->info();
- 查詢其他部落格公開資訊 $pixapi->blog->info($username);
- 取得部落格全站分類 $pixapi->blog->siteCategories();
- 取得建議標籤 $pixapi->blog->suggestedTags($username = '');

博客分类

- 取得部落格所有分類 $pixapi->blog->categories->search();
- 取得部落格單一分類 $pixapi->blog->categories->search($id, $is_folder = false);
- 新增部落格分類 $pixapi->blog->categoriescreate($name, $is_folder = false, $options = array());
- 修改部落格分類 $pixapi->blog->categories->update($id, $name, $is_folder = false, $options = array());
- 刪除部落格分類 $pixapi->blog->categories->delete($id, $is_folder = false);
- 修改部落格分類排序 $pixapi->blog->categories->position($ids);

博客文章

- 取得部落格個人所有文章 $pixapi->blog->articles->search($options);
- 取得部落格個人單一文章 $pixapi->blog->articles->search($id);
- 取得指定文章之相關文章 $pixapi->blog->articles->related($id, $options = array());
- 取得指定文章之留言 $pixapi->blog->articles->comments($id, $options = array());
- 新增文章 $pixapi->blog->articles->create($title, $body, $options);
- 修改文章 $pixapi->blog->articles->update($article_id, $title, $body, $options);
- 刪除文章 $pixapi->blog->articles->delete($id);
- 列出部落格最新文章 $pixapi->blog->articles->latest($options = array());
- 列出部落格熱門文章 $pixapi->blog->articles->hot($options = array());

博客文章评论

- 列出文章留言 $pixapi->blog->comments->search($options = array());
- 讀取單一留言 $pixapi->blog->comments->search($id);
- 新增文章留言 $pixapi->blog->comments->create($user, $article_id, $body, $options);
- 回覆文章留言 $pixapi->blog->comments->reply($id, $body);
- 將留言設為公開 $pixapi->blog->comments->open($id);
- 將留言設為悄悄話 $pixapi->blog->comments->close($id);
- 將留言設為廣告留言 $pixapi->blog->comments->markSpam($id);
- 將留言設為非廣告留言 $pixapi->blog->comments->markHam($id);
- 刪除文章留言 $pixapi->blog->comments->delete($id);
- 列出文章最新留言 $pixapi->blog->comments->latest($options = array());

好友互动

- 好友動態 $pixapi->friend->news($option = array());

群组

- 列出好友群組 $pixapi->friend->groups->search($option = array());
- 新增好友群組 $pixapi->friend->groups->create($name);
- 修改好友群組 $pixapi->friend->groups->update($id, $name);
- 刪除好友群組 $pixapi->friend->groups->delete($id);

好友列表

- 列出好友名單 $pixapi->friend->friendships->search($option = array());
- 新增好友 $pixapi->friend->friendships->create($name);
- 加入群組 $pixapi->friend->friendships->appendGroup($name, $id);
- 移除群組 $pixapi->friend->friendships->removeGroup($name, $id);
- 刪除好友 $pixapi->friend->friendships->delete($name);

订阅

- 列出訂閱名單 $pixapi->friend->subscriptions->search($option = array());
- 新增訂閱 $pixapi->friend->subscriptions->create($name, $options = array());
- 加入訂閱群組 $pixapi->friend->subscriptions->joinSubscriptionGroup($name, $group_ids = array());
- 離開訂閱群組 $pixapi->friend->subscriptions->leaveSubscriptionGroup($name, $group_ids = array());
- 刪除訂閱 $pixapi->friend->subscriptions->delete($name);

订阅群组

- 列出訂閱群組 $pixapi->friend->subscriptionGroups->search();
- 新增訂閱群組 $pixapi->friend->subscriptionGroups->create($name);
- 修改訂閱群組 $pixapi->friend->subscriptionGroups->update($id, $name);
- 刪除訂閱群組 $pixapi->friend->subscriptionGroups->delete($id);
- 修改訂閱群組排序 $pixapi->friend->subscriptionGroups->position($ids);

黑名单

- 列出黑名單 $pixapi->block->search();
- 新增黑名單 $pixapi->block->create($user);
- 刪除黑名單 $pixapi->block->delete($user);

留言板

- 列出留言版留言 $pixapi->guestbook->search($option = array());
- 讀取單一留言 $pixapi->guestbook->search($id);
- 新增留言版留言 $pixapi->guestbook->create($name, $body, $options);
- 回覆留言版留言 $pixapi->guestbook->reply($id, $body);
- 將留言設為公開 $pixapi->guestbook->open($id);
- 將留言設為悄悄話 $pixapi->guestbook->close($id);
- 將留言設為廣告 $pixapi->guestbook->markSpam($id);
- 將留言設為非廣告 $pixapi->guestbook->markHam($id);
- 刪除留言版留言 $pixapi->guestbook->delete($id);

首页

文章

- 列出文章專欄 $pixapi->mainpage->blog->columns();
- 列出全站熱門 $pixapi->mainpage->blog->hot($options);
- 列出全站最新 $pixapi->mainpage->blog->latest($options);
- 列出全站近期影片 $pixapi->mainpage->blog->hotWeekly($options);

相册

- 列出相簿專欄 $pixapi->mainpage->album->columns();
- 列出全站熱門 $pixapi->mainpage->album->hot($options);
- 列出全站最新 $pixapi->mainpage->album->latest($options);
- 列出全站近期影片 $pixapi->mainpage->album->hotWeekly($options);

视频

- 列出全站熱門 $pixapi->mainpage->video->hot($options);
- 列出全站最新 $pixapi->mainpage->video->latest($options);
- 列出全站近期影片 $pixapi->mainpage->video->hotWeekly($options);

用户

- 取得使用者資訊 $pixapi->user->info();
- 查詢其他使用者公開資訊 $pixapi->user->info(UserName);

索引

- 取得API使用次數資訊 $pixapi->index->rate();
- 取得API Server時間資訊 $pixapi->index->now();

许可

PIXNET SDK是BSD-2许可证，我们还提供额外的专利许可。