使用 Technorati API -2 开始：一个简单的例子

look_w

开始：一个简单的例子考虑  中的例子：
清单 1. 一个简单的搜索

1	http://api.technorati.com/search?key=xxxx&query=Obama

这个 URL 相当简单，它仅包含两个查询参数。
注意，实际的 Technorati API 函数是最后一个斜杠之后的单词（search）。显而易见，这表明 REST 调用将在博客圈中执行搜索。
第一个参数是密匙（key）。实际的 key 因用户而异，并不真的是 xxxx 字符串。要获得密匙，您需要注册 Technorati 并请求一个密匙。这很简单，也很容易。不幸的是，这意味着您不能将本文提供的 URL 复制粘贴到浏览器并查看结果。您必须使用自己的密匙替换 xxxx 字符串。
第二个请求参数是实际的查询。和手动例子一样，搜索使用关键词 Obama。
在您使用自己的密匙替换 xxxx 字符串之后，您就可以将这个 URL 复制粘贴到 Web 浏览器并查看返回的结果。返回的结果不一定相同，这取决于 Web 浏览器的品牌和版本。不管屏幕上出现什么结果，最好右键单击页面并选择 View Source 查看返回的实际 XML。
尽管实际的内容与您执行的查询有关，但结果应该类似于 。
清单 2. 一个简单搜索的结果（部分输出）

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27

<?xml version="1.0" encoding="utf-8"?> <!-- generator="Technorati API version 1.0 /search" --> <!DOCTYPE tapi PUBLIC "-//Technorati, Inc.//DTD TAPI 0.02//EN"     "http://api.technorati.com/dtd/tapi-002.xml"> <tapi version="1.0"> <document> <result>     <query>Obama</query>     <querycount>2270581</querycount>     <rankingstart></rankingstart> </result> <item>    <weblog>       <name>Critica Pura</name>       <url>http://criticapura.com</url>       <rssurl>http://criticapura.com/feed/&lt;/rssurl>       <atomurl></atomurl>       <inboundblogs>7</inboundblogs>       <inboundlinks>10</inboundlinks>       <lastupdate>2009-06-21 17:13:23 GMT</lastupdate>    </weblog>    <title>Jib Jab Obama</title>    <excerpt>Try JibJab Sendables</excerpt>    <created>2009-06-21 17:13:23 GMT</created>    <permalink>http://criticapura.com/2009/06/jib-jab-obama/&lt;/permalink> </item> ...

有意思的是，第一个查询结果是一个外语博客条目（至少对讲英语的人而言是这样）。
result 元素提供关于查询结果的元数据信息。query 的子元素提供实际的查询关键词。querycount 子元素提供来自博客圈并且与查询匹配的文章的数量。
许多 item 元素都跟在 result 元素之后。每个 item 元素都对应一篇与搜索条件匹配的博客文章。
weblog 元素提供关于博客本身的信息。该信息是关于整个博客的信息，而不是仅关于匹配搜索条件的文章的信息。 描述了 weblog 子元素。
表 1. weblog 子元素元素说明name博客的实际名称url博客的 URLrssurl针对该博客的 Really Simple Syndication (RSS) 提要的 URLatomurl针对该博客的 Atom 提要的 URLinboundblogs链接到该博客的博客的数量inboundlinks链接回到该博客的外部站点的数量lastupdate博客的最近更新日期和时间
中描述的元素是 item 而不是 weblog 的子元素。这些子元素引用文章本身。
表 2. item 子元素元素说明title博客文章的实际标题excerpt博客文章的纲要created文章的撰写日期和时间permalink博客文章的 URL