Wretch 無名小站 API - Yahoo! Developer

@2010/01/01 新增一篇更完整的教學：Wretch 無名小站 API - 申請、使用完整教學

記得以前寫過模擬瀏覽器的程式，像是模擬使用者登入、發表文章等程式，現在，終於不必再如此偷偷摸摸了！如果無名能夠再提供 XML-RPC 那就更好了！(好像也可以自己寫了？)，先來測試一下無名小站 API 吧！參考資料如下：

• YDN 開發者社群首頁


• Wretch API 文件 - TWOHD_Wretch API
  
  
  
  
  
  
  
  

  View more presentations from JH Lee.

  
  
  
  


• 
  
  2009 Tw Oh Wretch Api
  
  

  View more presentations from JH Lee.

  
  
  
  

至於要怎樣才能使用，我覺得比一般還麻煩一點點 :P

1. 申請 API 使用權
   
   
   
   
   • 連到網站上，填寫一些資訊即可
     
     
     
     • Kind of Application : Web-based
     
     
     • Application URL :  你家程式想跑的位置
     
     
     • Application Domain : 這比較麻煩，似乎不能帶 port 資訊
     
     
     • Access Scopes : 記得要選無名小站 Wretch 的 Read/Write 啦
     
     
     
     
   
   
   • 之後就會要確認 Application Domain ，要在網站根目錄擺在特定的檔名供 Yahoo 認證。
   
   
   • 如果蹦出 Domain Verification Failed 訊息
     
     
     
     • There was an internal error while an application is being created. Please try again.
     
     
     • 如果你沒用網域只有 IP 的話，請先申請個 Domain 吧！例如 http://tw.twbbs.org 可免費申請，一開始我懶的弄，僅用 IP 位置，結果在這邊卡關就不玩了 :P 幾天後我終於去申請網域後再 Try 成功囉
     
     
     
     
   
   
   
   


2. 下載 PHP Library
   
   
   
   • Using Yahoo! Social SDK for PHP
   
   
   
   


3. 測試 PHP 程式
   
   
   
   • 需要支持 curl 喔 (其實hack也是用這個lib寫的 XD)
     
     
     
     
     • sudo apt-get install php5-curl (Ubuntu安裝法)
     
     
     
     
   
   
   • <?php  
         require("Yahoo.inc");  
     
         // Your Consumer Key (API Key) goes here.  
         define('CONSUMER_KEY', "");  
     
         // Your Consumer Secret goes here.  
         define('CONSUMER_SECRET', "");  
     
         // Your application ID goes here.  
         define('APPID', "");  
     
         $session = YahooSession::requireSession(CONSUMER_KEY,CONSUMER_SECRET,APPID);  
     ?>
   
   
   • 將上述的相對位置弄一弄後，連過去就會將你導去 Yahoo 登入畫面，登入完就回到你的程式了
     
     
     
     • 登入者會收到 Yahoo 寄來的信件，其標題類似於"你的 Yahoo! 帳戶現已與 xxx 連結"，也可以再解除設定，就像在 facebook 上玩遊戲時的情況一樣，不想用可以再拿掉。
     
     
     
     
   
   
   
   

以上都搞定了，那代表可以真的開始寫程式囉！以下是一些小小的讀取範例！程式如下(別忘了加上上述測試Session的程式碼)：

<?php

$yahoo_user = $session->getSessionedUser();

// Profile
$url = 'http://wretch.yahooapis.com/v1/profileService/'.$yahoo_user->guid;
//$response = $session->client->get($url);
//print_r($response);

// Albums
$url = 'http://wretch.yahooapis.com/v1/albumService/'.$yahoo_user->guid.'/albums';
//$response = $session->client->get($url);
//print_r($response);

// Blog
$url = 'http://wretch.yahooapis.com/v1/blogService/'.$yahoo_user->guid.'/articles';
$response = $session->client->get($url);

print_r($response);


?>

寫入範例，建立相簿。但很奇怪地建出來都沒照我想要名字或敘述？比較想試的其實是發表文章至無名小站，但測試的結果都是錯誤訊息？改天有空再玩玩吧。經由 GTStudy 提醒，在 POST  的 contentType 設定成 "application/xml" 就可以成功建立相簿囉！我也順道找了一下投影片，裡頭的敘述果真詳細了一點，第 18 頁的確有看到這個關鍵字，十分感謝！

<?php

$yahoo_user = $session->getSessionedUser();

$url = 'http://wretch.yahooapis.com/v1/albumService/'.$yahoo_user->guid.'/albums';

$content = <<<multi_line_end
<?xml version="1.0" encoding="utf-8"?>
<req>
  <title>My title</title>
  <desc>My desc</desc>
</req>
multi_line_end;

//$content = simplexml_load_string($content);

$request = Array (
        'class_id' => 1
);
$url .= '?'.http_build_query( $request );

$contentType = 'application/xml';
$response = $session->client->post( $url , $contentType , $content );

print_r( $response );
?>

雖然無名小站正式提供不錯的 API ，但我覺得能提供如 MetaWeblog API 將會是更好的服務，但也許是綁著 Yahoo 帳號的關係，在管控上已經不能簡單化。更多 API 細節請至 Wretch API 文件 查看。