创建自己的自定义Web服务API时要记住什么?

时间:2010-05-10 12:33:26

标签: php web-services api

我创建了一个网站,允许用户注册和使用在线服务。为了帮助推广该网站,我们将有转售商,他们将通过我们提供自己的品牌服务。最初的计划是允许转售商在自己的网站上放置注册,登录和丢失的密码表单,并使用我们创建的API来处理这些请求。

我已经开始概述我希望API如何工作(并开始记录它),我想确保我做到正确,或者尽可能接近正确,因为我知道一旦你知道了已经声明了一个公共API,您希望不惜一切代价避免更改该API。

到目前为止,我已经决定:

  • 让用户为每个请求传递其帐户凭据
  • 要求所有请求使用SSL

我还应该记住什么?

1 个答案:

答案 0 :(得分:2)

这是Joshua Bloch的演示文稿,是API设计人员必读的内容:

http://www.infoq.com/presentations/effective-api-design