04
Nov

盲人摸象——读阿里妈妈API文档

看到阿里妈妈的API文档时,脸都绿了,写这文档的哥们儿太强了,要不就是我太无知了。

象腿一:接入

         1.1 接入
         1.2 接入方式:POST/GET方式
         1.3 接入类型:系统调用;页面跳转:立即返回处理结果,必须指定返回页面的

摸象Feeling One:我太无知了,在哪指定返回页面URL???知道的高手请赐教。

象脚二:协议参数

         2.1 输入参数:
                   2.1.1 接口名称service;具体参数值为业务接口名称(member_register||site_add||zone_add||ite_edit||zone_edit||site_info||zone_info)
                   2.1.2 签名sign;参数值为除和sign_type外的参数名与参数值
                   2.1.3 签名类型sign_type;具体参数值为(MD5||DSA||RSA)

         2.2 输出参数:
                   2.2.1签名sign;
                   2.2.2签名类型sign_type;

摸象Feeling Two:sign和sign_type还没完全搞懂,按我的理解和猜测应该是验证数据来源的安全性和可靠性。sign参数值其实是除sign和sign_type以外的参数名和参数值(这里就是”service=xxxx”),通过sign_type签名类型(MD5,DSA,RSA)的安全码验证(MD5类型)或公私密钥配对(DSA或RSA类型)成功后,按原签名类型输出sign字段;文档中的“Alimama为会员颁发的安全校验码”(MD5类型)和“Alimama使用会员的公钥”(DSA或RSA类型)是不可知的,看到论坛上有哥们儿要这俩东西,其实不必,只是不太了解sign_type的默认值,应该不会不写具体类型就明文传递吧?简单点,就是不用关心这俩东西到底咋回事,参数值直接留空,关心下面的业务接口就OK,当然,是个人认为……

象脚三:业务接口:

         3.1 用户注册(member_register)
         3.2 添加网站(site_add)
         3.3 添加广告位(zone_add)
         3.4 网站管理(site_edit)
         3.5 广告位管理(zone_edit)
         3.6 网站信息(site_info)
         3.7 广告位信息(zone_info)

摸象Feeling Three:具体的输入输出不介绍了,不过有几个疑点……疑点一:文档并没有说明各个业务接口返回的数据是怎么处理的,假如阿里妈妈处理函数是Alimama(service,sign,sign_type),那么我提交的service参数值到底是给service指定函数(如member_register)的函数地址,还是函数处理后的具体数据如数组或者类(class)?疑点二:member_register有个字段是logid,文档说明是“SSO(Single Sign-On:单点登陆)到Alimama使用”,那么这个字段是直接由用户函数实现还是Alimama提供?如果是由用户函数实现,如何验证其有效性?疑点三:新用户注册后会由XML返回其memberid,那么老用户的memberid在哪?怎么传递给会用到memberid的其他业务接口函数?比如调用site_info,新注册的用户我可以用cookie来实现存储memberid,老用户呢?我把阿里妈妈网站上的用户后台管理的链接都看完了,都没找到这个所谓的memberid,就是说,还不能通过外部来添加它,这是个巨大的问题!简言之就是缺少用户管理模块,实在是想不通啊,网站管理有,广告位管理也有,就是没有最重要的用户管理……

象脚四:附录

         4.1 测试环境;略
         4.2 约定;略
         4.3 代码表:
                   4.3.1 广告位尺寸;略
                   4.3.2 网站类型;略

摸象Feeling Four:约定给出的“按字母升序排序JAVA实现”做什么用?我是用PHP编程,你给我一段没注释的JAVA程序做什?

基本上摸完了,没摸到象头,或者说没摸到头脑……开始还自信满满地说要如何如何,看来我的水平太次了,完全跟不上阿里妈妈文档撰写人员的思路。iPhone啊iPhone,难道真的要等到你在中国上市才能拥有你?

8条评论

  • a gravatar 漫步 :

    啊哦,我不会php啊,所以参加不了啊,不过以 WordPress 中文团队成员之一 做为协办方也不错。lol

    另外,你博客是不是用的yahei字体啊。。。

  • a gravatar killy :

    我不是盲人,
    我连盲人都不如-__-|
    主要是我根本不懂这些,
    似乎也用不着吧,
    我可不想抢饭碗。
    嘿嘿~

  • a gravatar 宅哥 :

    @漫步:PHP比C简单,只要有编程基础就能学会,就是要记函数 -__-| 嗯嗯,是用的雅黑

    @Killy:貌似我在抢你的,哇哈哈~财务财务…

  • a gravatar 大猫 :

    木有基础滴人含泪飘过

  • a gravatar iStef :

    我终于明白你在我 Blog 留言说的啥了 -_-b。不过 Alimama 那份文档确实恶心。

    我也摸了摸,老用户的 securitycode 确实没有任何方案可获取,我先写着,等我写怒了就去骚扰 Alimama 的技术人员

    另外这套 API 应该算是 REST 方式,请求后返回的是 XML,用处理 XML 的方案来处理返回值就可以了。

    看来大家都是奔着 iPhone 去的,haha

  • a gravatar 漫步 :

    用yahei 字体也太恶了,我讨厌yahei
    另外,我也终于知道你在花儿那说的是啥意思了。

    瞧瞧的说一句,那文档我看都没看,别告诉别人哦。被团队成员看到会被k的。。

  • a gravatar Aby :

    你不是要参赛么。一天一blog怎么没有出现啊。。。

  • a gravatar 盛开 :

    Aby on 2007-11-11 at 10:34 said:

    你不是要参赛么。一天一blog怎么没有出现啊。。。

    怎么没有,比较晚写而已 -__-||

LEAVE A COMMENT

Comments RSS Feed   TrackBack URL