Rest API 设计（推特）答案

【问题标题】：Rest API design ( twitter )Rest API 设计（推特）
【发布时间】：2011-08-04 14:13:34
【问题描述】：

我想为一个项目构建一个 rest api，所以目前我正在尝试使用 twitter api 构建一些东西。我在 Twitter 上注册了一个新应用程序。注册后我有以下密钥

消费者密钥
消费者秘密
请求令牌网址
访问令牌网址
授权网址
注册的 OAuth 回调 URL

那么这些键是什么？所有这些都适合 Rest api 设计考虑因素

谢谢:)

【问题讨论】：

您是在设计自己的 API，还是在为 Twitter 的 API 编写客户端？
我想最终写自己的api，但首先我想用别人的api来适应它，这样我才能写得更好

标签： c# rest twitter

【解决方案1】：

这些是 OAuth 参数，放置它们的最佳位置是在 Authentication 标头中。请参见第 5.4.1 节中的示例。这里http://oauth.net/core/1.0/#consumer_req_param。

身份验证是一个完全独立于 REST 的问题，因此为了回答您的问题，您列出的那些参数与 RESTful 设计完全无关。

【讨论】：

哦...这些参数我在大多数rest api中都看到过...是否可以先创建一个rest api然后担心身份验证...或者我需要考虑设计 api 时进行身份验证
@taher 首先构建 api。您可以随时添加身份验证。
@Darrel .. 我正在寻找一本关于 Rest 的好书，SO 上的每个人都在推荐 Restful Web 服务......但是这本书是 2007 年出版的......你知道有什么书吗？最近的和权威的......或者那本书仍然与 REST 相关
@taher oreilly.com/catalog/9780596801694 和 oreilly.com/catalog/9780596805838

【解决方案2】：

如果您有兴趣在 Twitter 之后设计您的 RESTful API，那么我建议您研究 Twitter 组织其 API 资源的方式（请参阅右侧边栏中链接下的方法文档here），它们如何支持不同的资源格式（通过更改所请求资源的扩展名，如 .xml 或 .json）、它们如何对端点进行版本控制，以及每个资源支持哪些动词（例如，oauth/request_token 方法如何同时支持 POST 和 GET 方法）。

因此，请研究 Twitter 生成的界面，暂时先忽略其背后的实际实现，并使用它来帮助回答您的设计问题。专注于您想通过界面公开的内容。您打算如何投影通过界面公开的对象？您会选择支持哪些资源格式？您打算如何对服务端点进行版本控制？

顺便说一句，如果您有兴趣了解其他 RESTful API，可以使用 apigee 进行探索；他们有一个 Twitter 控制台here。

【讨论】：

是的，Twitterizer 是 Twitter API 的包装器。它包含 Twitter OAuth 消费者的实现，而不是服务提供者。这就是我最初认为您要寻找的东西；我从答案中删除了该行。