Rest API 设计（twitter）

Question

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

1. 消费者钥匙
2. 消费者的秘密
3. 请求令牌URL
4. 访问令牌 URL
5. 授权网址
6. 注册OAuth回调URL

那么这些键是什么以及所有这些都适合 Rest API 设计考虑因素吗

谢谢:)

Answer 1

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

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

Answer 2

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

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

顺便说一句，如果您有兴趣查看其他 Restful API，您可以使用 apigee 进行探索；他们有一个 Twitter 控制台这里。