星期二, 8月 28, 2007

[Note]如何使用 Box.Net API?

當然,已經有人開發好 Library 的話,那麼直接使用是最快的。
所以第一步就是上 Box Enabled - Sources 看看,是否有合用的。
目前已經有 PHP、Python、Action Script 3 的版本可以使用。

找不到的話,第二步就是去 Box Enabled - Projects 找找看是否有人正在寫。

再不成,那麼就是要自己寫了。
官方的文件其實相當齊全,你可以參考Box Enabled - Documents
你有三種方式可以存取:SOAP、XML POST、REST

我這裡以REST來舉例:
  1. 取得 API key:你得先註冊成 developer,建立你的 project,才能取得 API Key。
  2. 要使用任何功能前,你必須先取得 Ticket,訪問 http://www.box.net/api/1.0/rest?action=get_ticket&api_key=your_api_key (your_api_key請自行帶入),Parse 收到的XML,取得 ticket,這裡有輸出結果的範例。
  3. 利用 Ticket 進行 login,這個動作實際上就是 POST 這些資訊
    dologin=1
    __login=1
    login=your_email
    password=your_password
    到 http://www.box.net/api/1.0/auth/your_ticket 這個網址去。
  4. 取得 auth_token:登入完成以後,就可以訪問 http://www.box.net/api/1.0/rest?action=get_auth_token&api_key=your_api_key&ticket=your_ticket,再 Parse 收到的 XML,取得 auth_token,同樣地,這兒有很好的釋例。
  5. 拿到的 auth_token,接下來想幹麼就可以幹麼了。例如,上傳檔案,你只要 POST 檔案(your_file)到 post 到 http://upload.box.net/api/upload/your_auth_token/your_file 就可以了。


事實上,有 SOAP (就是Web Service)的話,在某些語言來說,是很方便的,例如 .Net 就可以直接利用 Add web reference 或是利用 wsdl 指令列工具來產生代碼:wsdl /language:cs http://box.net/api/1.0/soap?wsdl ...

沒有留言: