淘宝开放API的文档漏洞百出，对广大开发者不负责任

最近想开发一个淘宝应用程序玩玩，就研究了淘宝的开放API，开始是从文档入手，但是感觉内容写的很分散，无法突出重点，跟GOOGLE MAP API的文档比简直是天壤之别，若仅仅如此，凑合看也就罢了。但在我开始写代码之后，才发现问题比想象中的要严重，我最担心的事情还是发生了：文档和代码不一致，对照淘宝的模拟测试环境，发现生成的查询字符串与文档上有时候有出入。这样我根据文档编写的程序在调试时通不过，没有办法就用模拟测试环境生成的字符串一个一个对比，查找不同之处，虽然最终解决了问题，但是这导致我花费的巨大的时间在调试上面。

第一个例子：format or sip_format?

在API文档中说明如下：



根据这个文档，我们应该使用sip_format，然而使用官方的模拟测试工具却并非如此，请看：


 

提交参数中居然又是format, 明显的不一致，那么我们应该用哪一个的，只有自己去尝试，因为这个参数说明是可选参数，我实验之后好像都可以。

这样的问题说明官方的API设计不够严谨，文档中还有一些其它的问题，找时间再补充上来，淘宝这样的API，浪费了开发者的大量时间和精力去调试，很难有一个功能是一步调通的，是对开发者的不负责。