正在欣赏福报厂的 api 文档,什么水平才能写出这样的文档啊

7 天前
 wencan

rt
完全不是写给人看的 看了几个小时,我还不知道从哪里开始,我需要的功能应该调哪几个 api
每个 api 都没解释清楚,比如下面是一个字段的介绍:

feature 参数格式
范例: identCode=tid1:识别码 1,识别码 2|tid2:识别码 3;machineCode=tid3:3C 机器号 A,3C 机器号 B
identCode 为识别码的 KEY,machineCode 为 3C 的 KEY,多个 key 之间用”;”分隔
“tid1:识别码 1,识别码 2|tid2:识别码 3”为 identCode 对应的 value 。"|"不同商品间的分隔符。
例 1 商品和 2 商品,之间就用"|"分开。
TID 就是商品代表的子订单号,对应 taobao.trade.fullinfo.get 接口获得的 oid 字段。(通过 OID 可以唯一定位到当前商品上)
":"TID 和具体传入参数间的分隔符。冒号前表示 TID,之后代表该商品的参数属性。
"," 属性间分隔符。(对应商品数量,当存在一个商品的数量超过 1 个时,用逗号分开)。
具体:当订单中 A 商品的数量为 2 个,其中手机串号分别为"12345","67890"。
参数格式:identCode=TIDA:12345,67890 。TIDA 对应了 A 宝贝,冒号后用逗号分隔的"12345","67890".说明本订单 A 宝贝的数量为 2 ,值分别为"12345","67890"。
当存在"|"时,就说明订单中存在多个商品,商品间用"|"分隔了开来。|"之后的内容含义同上。

奇怪淘宝的代码是怎么跑起来的?

几年前曾经对接福报厂 ding 的 api ,和同事嘲笑了 ding 的技术实力好久。后面网上一查,ding 的实力居然还是厂内实力比较强的。现在看来,强了不止一点半点啊

2449 次点击
所在节点   淘宝
10 条回复
bxb100
7 天前
一般都是外包写的…
TyCoding
7 天前
基本都是外包写的,甚至大部分产品都是外包写的
potatowish
7 天前
奇怪难道别家文档不是外包写吗,国内腾讯的文档相对来说挺清晰的
laikick
6 天前
@potatowish 腾讯的文档还清晰? 老中公司的文档都藏着捏着.
wencan
6 天前
@laikick 哪家文档没毛病?相对来说,腾讯的文档还算清晰,毕竟那么多开发者接入
福报厂的文档,明显已经不是毛病不毛病,清晰不清晰的问题了
laikick
6 天前
@wencan 国外的公司就开放清晰. 都不用注册随便看 老中的看个文档都恨不得要你实名制
luckyrayyy
6 天前
倒排工期没空写,人力不足召唤外包,每年换三波人维护,以上就是大厂常态。
donaldturinglee
6 天前
有时候根本不知道该怎么调接口和传参数. 写的 UML 也是云里雾里
yikyo
6 天前
没几个平台 API 写的不错,没记错的话微信支付有个大小写参数的问题,第一次对接很容易掉坑,网易 im ,风格不统一,有直接返回的,有回调返回的,没有固定参数格式,很明显是好几波人维护后的结果
wceozl
6 天前
有幸做过钉钉小程序,api 全靠微信小程序文档和自己猜

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/1101741

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX