Posts Tagged: api


3
Aug 07

Web APIs by Example, Part II: del.icio.us

Today we’ll be looking at applying what we’ve already learned from working with the Twitter API to the social bookmarking site del.icio.us. As you might expect, the del.icio.us API offers a much broader set of functionality for interacting with it’s data. Besides being able to add bookmarks, you can delete existing ones and use a number of different methods to selectively filter your bookmarks and return just the ones you’re looking for. It’s quite nice, and today we’ll be exposing some of these features with an app that lets us add bookmarks as well as filter our most recent ones.

$delicious_username = 'YOUR_USERNAME_HERE';
$delicious_password = 'YOUR_PASSWORD_HERE';

$errno = 0;
$errstr = '';
$response = '';

$links = array();

function httpRequest($host, $path = '/', $method = 'GET') {

	global $errno, $errstr, $response;
	global $delicious_username, $delicious_password;

	$port = 80;
	if(substr($host, 0, 6) == 'ssl://') $port = 443;

	$sock = @fsockopen($host, $port, $errno, $errstr, 30);
	if (!$sock) {
		if(!$errno) {
			die("

fsockopen() error:Unable to open socket for undefined reason; most likely the version of PHP you're running doesn't have SSL support compiled.");
		} else {
			die("

fsockopen() error:$errstr ($errno)

");
		}
	} else {

		$host = substr($host, 6);
		$header  = "$method $path HTTP/1.0\r\n";
		$header .= "Host: $host\r\n";
		$header .= "Accept-Encoding: none\r\n";
		$header .= "Authorization: Basic " . base64_encode("{$delicious_username}:{$delicious_password}") . "\r\n";
		$header .= "Connection: Close\r\n\r\n";

	    fwrite($sock, $header);
	    while (!feof($sock)) {
			$response .= fgets($sock, 128);
	    }
	    fclose($sock);

	    $response = str_replace("\r", '', $response);
	    $response = trim(substr($response, strpos($response, "\n\n")));
	    return true;
	}

}

if(isset($_POST['url']) && isset($_POST['description'])) {

	// Bookmark a URL

	$url = urlencode(trim($_POST['url']));
	$description = urlencode(trim($_POST['description']));
	httpRequest('ssl://api.del.icio.us', '/v1/posts/add?url=' . $url . '&description=' . $description);

}

// Fetch our recent bookmarks:

$count = 10;
$tag = '';

if(isset($_GET['count']) && strlen($_GET['count']) && is_numeric($_GET['count'])) $count = trim($_GET['count']);
if(isset($_GET['tag']) && strlen($_GET['tag'])) $tag = urlencode(trim($_GET['tag']));

$ret = httpRequest('ssl://api.del.icio.us', '/v1/posts/recent?count=' . $count . '&tag=' . $tag);

if($ret) {
	$xml_parser = xml_parser_create();
	xml_parser_set_option($xml_parser, XML_OPTION_CASE_FOLDING, true);
	xml_set_element_handler($xml_parser, 'parsePostOpen', 'parsePostClose');
	xml_parse($xml_parser, $response, true);
}

function parsePostClose($parser, $name){}
function parsePostOpen($parser, $name, $attrs)
{
	if(isset($attrs['HREF'])) {
		$attrs['TIME'] = strtotime(substr($attrs['TIME'], 0, -1));
		$attrs['TAG'] = explode(' ', trim($attrs['TAG']));
		global $links;
		$links[] = $attrs;
	}
}

?>

My Recent Bookmarks

Filter Results Display the <option selected="selected">10 <option selected="selected">50 <option selected="selected">100 most recent bookmarks, tagged with <input type="text" id="tag" name="tag" value="" />  
  • <a href=""> — Tagged with <a href="?tag=">
New Bookmark

That’s it! If everything’s gone right, you’ve got yourself a pretty slick little bookmark manager for del.icio.us. Hope you enjoyed this article, and please feel free to comment with any questions or additions. I have a few more additions planned to the series, so stay tuned.

Download the Source Code


1
Aug 07

Web APIs by Example, Part I: Twitter

APIs, or application programming interfaces, are essentially standardized methods for applications to talk to one another and share information. In desktop applications, the operating system provides a full range of APIs in order for your programs to run and interact with it (in Windows an app might register itself as an option for when you right click an icon; or on a Mac an app will hide itself from the dock.) On the web, APIs are usually provided as a means of importing data to other services, or using third party clients to push information to your account.

Since Twitter is all the rage these days, I thought it would be a great starting point to introduce you to the world of web APIs and how simple they really are to work with. Twitter, like most presencing services, has a very limited range of API calls because, well, it’s a very simple service. The documentation for Twitter’s API can be found hrere. The Twitter API, all be it simple, has allowed great applications like Twitterific and Twittervision to be created.

Continue reading →