13 years C/C++/C# programing, focus on embedded and mobile device development.

  博客园 :: 首页 :: 博问 :: 闪存 :: 新随笔 :: 联系 :: 订阅 订阅 :: 管理 ::

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

第一个例子:format or sip_format?

在API文档中说明如下:


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

 

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

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

 

posted on 2008-11-28 18:06  woaiusd  阅读(2219)  评论(15编辑  收藏  举报