为什么说开发者应该放弃人人网开放平台？

最近一段时间我都在利用业余时间折腾一些网站和应用，为了让用户使用现有的社交帐号登录，我开始研究国内各大网站的开放平台，其中包括新浪微博、人人网、QQ 和豆瓣网。在使用人人网开放平台的过程中，从开发程序到提交审核，每一步都充满了痛苦和不适，我甚至有点怀疑它是人人网的工程师用来折磨同行的工具。

如果你没有耐心看比较长的文章，或者是遇到了人人网开放平台相关问题之后通过搜索到了这里，那么我长话短说：请放弃人人网开放平台，它不值得你为它投入的每一分钟。

接下来我会列举出我所了解的人人网开放平台的缺陷。我相信，最后就算是仅仅因为同情我的痛苦经历你也会毫不犹豫地放弃它。

1. API 设计糟糕

对于一个开放平台来说，API 是最关键的部分。它应该设计得易于使用和调试，这样开发者才能很快地学习如何使用相应的 API 来获取需要的数据，这对于开放平台来说是一个起码的要求。人人网开放平台是如何做的呢?首先，它简单粗暴地明确规定：

所有的人人网开放平台API都是通过HTTP POST向人人网开放平台REST API服务器(http://api.renren.com/restserver.do) 发送请求来实现的。

一般来说，「读取」而非「写入」的操作只需要使用 GET 方式来请求，这样很方便调试。有时候我们不太相信文档中给出的数据格式，需要直接请求 API 来拿到一些数据样本，例如，豆瓣获取用户信息的 API 地址为：api.douban.com/v2/user/:name ，那么我可以很简单地在浏览器中直接输入 http://api.douban.com/v2/user/1000001 来拿到相应的数据。而如果使用 POST 方式，那么我就必须写一段代码或者借助工具来模拟 POST 请求，可能还会遇到很多恼人的小问题。

另外，在用户认证的时候，虽然人人网现在采用了 OAuth 2.0 作为认证方式，但还是必须要提供一个 OAuth 1.0 才需要的签名，而且计算方法非常复杂。我猜想他们可能是为了兼容老的接口才想出了这种丑陋的设计。曾经我为了计算这个签名反复核对自己的代码，但总是出现一些莫名其妙的错误，而且通过错误信息无法找到解决办法。

人人网开放平台的 API 还有很多其它各式各样的问题，比如参数描述很不明确、默认返回数据的格式是 XML 而不是 JSON 等。一个网站既然要做开放平台，它就应该做出为开发者服务的姿态，这样才会有开发者愿意为它贡献力量，大家一起打造一个良好的生态环境。反之，如果连 API 这种最基本的「服务」都做不好，谁会愿意来光顾呢?

微信扫一扫实时了解行业动态

微信扫一扫分享本文给好友