支持的特性用 Digg API 可以做很多有用的事情。前面已经提供了几个简单的例子，现在详细介绍它的一些特定特性。
Get Popular Stories这个 Get Popular Stories 端点是您已经看到的端点之一，而且可能是大多数开发人员都会用到的端点。顾名思意，这是用于从 Digg 检索文章的端点。
该端点的方法名是：
/story.getPopular
当然，必须指定完整的 URL，如下所示：
http://services.digg.com/1.0/endpoint?method=story.getPopular
跟其他端点一样，该端点接受关于应该返回什么文章的规范。本例中没有规范，所以 Digg 返回所有流行的文章。在 的例子中，规范是来自 Entertainment 容器的流行文章（&container=Entertainment）。
不管出于何种原因，如果没有提供任何规范，那么将会检索 Digg 中的所有文章，具有适当的限制。该 URL 应该类似于刚才上一段的那个 URL。从该 URL 返回的结果只包含前 10 篇文章，以节省带宽。使用 count 参数，最多可以将返回文章的篇数增加到 100，如下所示：
http://services.digg.com/1.0/endpoint?method=story.getPopular&count=30
该 URL 将返回 30 篇文章，而不是默认的 10 篇。
列出故事的另一个有用的选项是，列出预定的（upcoming）故事：
http://services.digg.com/1.0/endpoint?method=story.getUpcoming
这将返回您手动进入以下 URL 时会看到的内容的 XML 等价物：
http://digg.com/all/upcoming
已经了解了如何从给定容器抽取故事。但是对于希望使用该特性的用户，有更多的选项可用。一个选项允许用户从特定容器检索最流行的文章。还是以 Entertainment 种类为例，该 URL 类似于：
http://services.digg.com/1.0/endpoint?method=story.getTop&container=Entertainment
注意，这里使用的是 getTop 方法，而不是 getPopular 方法。
也可以通过使用 getUpcoming 方法而不是上面 URL 中的 getTop 方法，查看特定种类的预定文章：
http://services.digg.com/1.0/endpoint?method=story.getUpcoming&container=Entertainment
Get CommentsGet Comments 端点像 REST 调用中指定的那样返回一系列评论。回想一下，Digg 用户可以对已提交的文章发表评论。该特性根据请求中的规范进行过滤，返回这样一些评论。
该端点的方法名是 story.getComments。
要查看特定故事的所有评论，可使用下面这个 URL：
http://services.digg.com/1.0/endpoint?method=story.getComments&story_id=17390757
story_id 请求参数是必需的，并且应该设置为文章（带有您想要查看的评论）的故事 id。输出应该类似于 ：
清单 2. Digg 评论：输出1
2
3
4
5
6
7
| <?xml version="1.0" encoding="utf-8" ?>
<events timestamp="1261234852" total="14" offset="0" count="10">
<comment date="1259165131" id="29563488" story="17390757"
up="10" down="1" replies="1" replyto="" user="Manchildcartoon"
level="0" root="29563488">That's not true...THAT'S IMPOSSIBLE!!!</comment>
<!-- The other 9 comments appear here -->
</events>
|
这返回 10 条 XML 格式的评论（记住，Digg 只返回 10 条，除非您特别指定了更多条）。每个评论出现在一个 comment 元素中，作为 events 元素的子元素。上面的输出中展示了一条评论 — 其他 9 条评论类似于这一条。参数指定评论的日期、故事标识符、事件标识符以及输入该评论的用户。注意，Digg 事件也可以是实际的 digg，而不是简单的评论；如果是那样的话，事件应该出现在 digg 元素中。
Get Users顾名思意，Get Users 特性得到 REST API 中指定的 Digg 用户。
该端点的方法名是：
/user.getAll
记住该特性，然后考虑以下 URL：
http://services.digg.com/1.0/endpoint?method=user.getAll&usernames=Manchildcartoon
有必要指出来，对于该特性来说，usernames 参数是必需的。它应该设置为一个逗号分隔的用户名列表，这些用户的信息是您想要检索的。这将返回类似于 的结果：
清单 3. Digg 用户：输出1
2
3
4
5
| <?xml version="1.0" encoding="UTF-8"?>
<users count="1" offset="0" timestamp="1261394886" total="1"
version="1.0"><user icon="/users/Manchildcartoon/l.png"
name="Manchildcartoon" profileviews="565" registered="1228079424"/>
</users>
|
可以看到，结果包含关于特定 Digg 用户的信息，其中包括用户的图标（可能是他们的照片）、用户是何时注册的，以及用户简介被浏览的次数。 |
