一、前言
早在前年 12 月,筆者就萌生了用 Node 抓取微博數據的想法,於是簡單封裝了 nodeweibo 這個庫。時隔一年,由於沒有太多精力維護,中途只把函數形式改成了配置文件。期間做的其他一些項目也相繼下線,为的是更專註於前端與 Node.js。偶然間發現它的下載量一天能超過 60 次,一直有人在用,但由於總量不多也就沒急於更新。直到昨天有人對這個分支發起了 pull request,提出了不少中肯建議和實用代碼,於是便認真回顧了一遍 nodeweibo,並發布了 v2.0.3 版本。
二、nodeweibo 是什麼
nodeweibo 對微博的 API 進行了簡單封裝,讓你能在 Node 環境中以函數調用的方式使用微博各項接口。
GitHub 項目地址:https://github.com/vczero/node-weibo
這裡放一張 markdown 文檔的截圖,具體內容可前往項目頁查看。

安裝方式:npm install nodeweibo
三、支持的 API
支持的接口清單見:https://github.com/vczero/node-weibo/blob/master/doc/api.md
目前基本覆蓋了微博的絕大部分 API,以下為部分截圖;這份文檔由 George Mason University 的 xizhonghua 幫忙補充,特此致謝。

四、示例代碼
var Weibo = require('../../nodeweibo'); // 若已通過 npm 安裝,也可寫成 require('nodeweibo')
var setting = require('./setting.json'); // 獲取配置(appKey、appSecret 等)
/*
+-------------------------------------------------
(1) 註冊賬號:https://open.weibo.com/
(2) 在 ./setting.json 中配置你的開發賬號。
(3) 搞清楚微博的認證機制,即 oauth2.0 認證原理。
(4) 第 3 點很重要,確保你理解這種開放方式。
+-------------------------------------------------
*/
// 使用前先初始化
Weibo.init(setting);
/*
+-------------------------------------------------
例 1:開啟微博認證
啟動認證後,會在瀏覽器打開一個窗口,url 中含有 code 參數。
注意:運行其中一個例子時,須注釋掉另一個例子。
+-------------------------------------------------
*/
Weibo.authorize();
/*
+--------------------------------------------------
例 2:獲取 access_token
(1) 閱讀微博開放平台 API,如 https://open.weibo.com/wiki/OAuth2/access_token,
將必要參數寫進 jsonParas 對象。
(2) 在回調中打印獲取的數據。
(3) code 是瀏覽器窗口獲得的 code。
(4) 注意:如運行本例子,請注釋掉第 1 個例子,且 code 只能調用一次,
它會隨着認證不斷更新,一個用戶對應一個 access_token。
+---------------------------------------------------
*/
// var jsonParas = {
// code: "the value of your browser's parameter code",
// grant_type: "authorization_code"
// };
// Weibo.OAuth2.access_token(jsonParas, function (data) {
// console.log(data);
// });
/*
example 3, get public timeline
*/
// var para = {
// "source": Weibo.appKey.appKey,
// "access_token": 'your access_token here'
// };
// Weibo.Statuses.public_timeline(para, function (data) {
// console.log(data);
// });
五、總結
(1)發布一個 package 時,盡量把文檔寫全一些,這樣使用者會更方便,這也是一種開發態度。
(2)既然有人使用你的 package,就盡量花些時間維護它。今年年初就有人來問過使用方法。
(3)研讀他人的代碼本身就是樂趣,體會別人的工作思路也能提升自己的開發效率。