吐嘈一下支付宝alipay的技术文档

dcc82

这两天在为一个custom built app集成支付宝的功能，下载了相关的技术文档，差点吐血
就一个zip包，解压了之后好几个文件夹，零碎的分布了好些个doc文档。话说如今这个web/app充斥的年代，技术文档用doc来作为发布我还是很少看到的，让我不禁想起了我父母家小区的物业，他们时不时的会发个小区通告整顿垃圾什么的，那些好像都是doc格式。问题在于，哪个都不知道是哪个，屏幕上开了一堆word文档，陷入一头雾水。
里面有个php版的sample，代码写的连个基本规范都没有，更奇特的是用于支付的测试账号居然分布在好几个文档中，没有一个好用的。
技术文档写的像自动生成的，不求达到paypal和stipe的5%的技术文档质量，但写的干净易懂一些要求不高吧？国内抄硬件外观抄的这么好，这种软件文档怎么抄的那么差？感叹国内程序员的理解思维真是好，能看懂这样的天书，也可能是我被paypal和stipe惯坏了理解思维退化了。
最后，没有sandbox，一个支付网关居然没有sandbox你能相信吗？文档中建议在真实环境中测试，只要金额改成0.01usd，我跪了！～！！
（后来Baidu搜索了一下貌似有个阉割的Sandbox,可是英文技术文档内只字未提，而且必须要等合同签约开通后才行，天哪～～）

sonybp

你确定你找的不是山寨的alipay？

我前两年开发这块的时候就两个文档
Alipay General Payments API Specification V2011 （Revised）.doc

Alipay testing environment.doc就是你要的sandbox。连的是alipay.net，真实环境是alipay.com

再清楚不过了。alipay有php, asp, asp.net, java的sample code。当时开发的时候觉得alipay还是比较专业的。除了联调的时候用qq交流这块有点醉了。

dcc82

sonybp 发表于 2014-10-19 13:07
你确定你找的不是山寨的alipay？

我前两年开发这块的时候就两个文档

2011年时可能相对简单一些，但是现在不好意思，我觉得离专业差的十万八千里，尤其是技术文档的书写与格式。现在光是文档就有3个pdf,2个docx，sample代码无法运行，提供的测试账号一个在faq文档中，一个在另一个文件，很混乱。英语的2个文档更是还有好几个spelling问题这是极其不应该的.
昨天已经联系他们的客服了，到现在还没有回应，打算明天打电话过去。

dcc82

sonybp 发表于 2014-10-19 13:07
你确定你找的不是山寨的alipay？

我前两年开发这块的时候就两个文档

还有那个Alipay testing environment.docx 里面umidprod.alipay.net的IP我刚打开眼睛一喵到就发现是错的，而且只写了Windows的，而且是个绝对路径C:\Windows\system32\..，没写osx, ubuntu/centos（反正大家都会改hosts，只是从类似细小的地方能够看出来这技术文档的质量我只能呵呵了）英语我真的不想多说了，这里还只是随便贴个截图 单复数乱用setting(should be plural - settings) Add the flowing to hosts file. 一句话能出现1处拼写错误，2处语法错误我也真的服了。你可以想像通篇的英语文档有多少错误，找个proofreader不难吧？很奇怪的，他们这个zip文档里只有其中一个文档有中文版的。
后面提供的http和https示例测试连接也是无效的，无效的东西放在文档里干吗。既然说到沙盒，我突然忘记说了，鉴于上面提到测试账号没法使用，于是我就试不同的组合，居然在测试环境下输入3次错误后会封个3个小时，有没有搞错？这是测试环境啊。

无论怎么说，就算文档中有这样那样错误，大家都是聪明人，相信绝大数的程序员最终都能搞定掉的。我这里也只是感叹一下觉得像这种技术文档质量，这样的书写方式，这样的发布格式，与这么一个有影响力公司的技术形像有很大出入。

bullying520

很早就听说过了....

sonybp

原来是吐槽英文的。

很明显是国内程序员的英文水平。而且我相信这个文档的受众大部分都是有中文背景的程序员。能有这个水平我已经满足了。毕竟是互联网公司，不是软件公司。

dcc82

sonybp 发表于 2014-10-19 23:43
原来是吐槽英文的。

很明显是国内程序员的英文水平。而且我相信这个文档的受众大部分都是有中文背景的程序 ...

申请合同的时候，它们技术支持看到的是国外的注册机构，所以就直接扔个全英文的zip开发包给在国外的开发者，其他下载的页面也都是英文的，所以不应该存在是给中国人看的问题，或是假想开发者有中文背景。既然是全英文的文档，我认为就应该写的严谨一些，一步步应该写的尽可能的清楚。英文语法和拼写虽然只是很小的一部分，但也能反应出事实。而技术文档的本身质量才是最有问题的，如果是小公司我也懒的去吐了，但作为一个有威望的公司，跟paypal的文档真的不能相比，而两者都是payment gateway，文档甚至还没有小公司写的专业，这才是我所要说的重点。

mengqing

明显是零时工做的

netstat

ali国际化水平还是太差呀

bowensyd

外表光鲜就行了，能上市就行了，能卖得出钱就行了，代码质量大家看看就行了。

明月星光

dcc82 发表于 2014-10-20 22:36
申请合同的时候，它们技术支持看到的是国外的注册机构，所以就直接扔个全英文的zip开发包给在国外的开发 ...

paypal的文档…… 新的developer.paypal.com的还凑合，旧API文档我觉得和alipay半斤八两，11个支付产品连个区别都说不清。

大爱stripe ω

Feb

看来淘宝国际化还有段路要走。。。千万不要把客服外包到印度，哈哈哈哈