[宅] facebook開發日誌 - facebook API入門(1)

2012年11月2日星期五

[宅] facebook開發日誌 - facebook API入門(1)

在開發facebook相關應用的時候一直沒有好好地做一個整理，
最近有個應用需要query使用者在timeline上發的照片，~~正好趁此筆記一下FQL這個東東~~結果一不小心就寫成API的介紹文。

前言

facebook提供開發者四種API：

Login
Graph API
FQL
Legacy REST

但在開始介紹API之前必須先提授權碼(access token)的概念，讓我們使用Graph API Explorer這個好用的facebook開發工具來一步一步了解access token的概念。
首先，登入 http://developers.facebook.com/tools/explorer/ ，你會看到以下畫面：

先在"GET"旁邊的輸入欄打"ME"，然後送出。如果你從來沒有使用過這個工具的話，就會看到以下訊息：

{
  "error": {
    "message": "An active access token must be used to query information about the current user.", 
    "type": "OAuthException", 
    "code": 2500
  }
}

這代表你沒有權限存取現在的facebook使用者(你自己)的資料，但在取得這個權限之前，我們先來做另一個小試驗：在同一個地方打"zuck"，相信你會看到以下訊息：

{
  "id": "4", 
  "name": "Mark Zuckerberg", 
  "first_name": "Mark", 
  "last_name": "Zuckerberg", 
  "link": "http://www.facebook.com/zuck", 
  "username": "zuck", 
  "gender": "male", 
  "locale": "en_US"
}

眼尖的你可能馬上就發現了這是facebook創辦人Mark Zuckberg的基本資料，酷吧！
但是為什麼自己的資料拿不到，卻可以拿到別人的資料勒?因為Zuckberg是特例嗎?一定是這樣子的吧哈哈哈！

其實不是特例，因為你打別人的名字也是一樣，Peter、John、Mary之類的菜市場名都可以試試，甚至你如果曾在facebook上取過英文也可以試試看....

"X!真的可以耶!這是怎麼回事!?"

這是因為"ME"是取得任何正在瀏覽這個網頁的facebook user的參數，這樣開發者就可以很靈活的寫相關應用。所以雖然基本上不用任何acess token也可以取得特定使用者的基本資料(使用特定ID)，但要用ME來靈活運用使用者資料就得要取得你的授權(acess token)了。

所以前面出現的"OAuthException"就是因為Graph API Explorer還沒取得你的授權，所以不能用ME來取得你的資料的錯誤提示。現在我們就點選Graph API Explorer頁面上的"取得存取代碼"這個按鈕來讓它取得你的授權，然後就會彈出這個視窗：

上面佈滿了各種選項，代表了你要讓這個應用程式存取那些權限，點選"user_about_me"以後送出就會看到熟悉的畫面：

現在你應該知道facebook app的登入畫面是怎麼來的了

之後Graph API Explorer就可以使用你的基本資料，輸入"ME"之後也會順利的出現相關訊息，這個簡單的步驟解釋了app從登入到使用你的資料的基本流程，也是facebook應用開發者的第一步。

而Graph API Explorer可不只是facebook開發的入門工具，畢竟facebook所提供的API還不少，所以即使是有開發經驗的工程師也會時常使用這個工具來驗證自己的邏輯是否可以正確運作。

身為一個開發者，只知道這些是不夠的，請讓我們往下一篇邁進！