正在欣赏福报厂的 api 文档,什么水平才能写出这样的文档啊 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
wencan
V2EX    淘宝

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

  •  1
     
  •   wencan 288 天前 3708 次点击
    这是一个创建于 288 天前的主题,其中的信息可能已经有所发展或是发生改变。

    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 的实力居然还是厂内实力比较强的。现在看来,强了不止一点半点啊

    第 1 条附言    253 天前
    最后选择了向第三方交钱买路
    10 条回复    2025-01-02 09:49:40 +08:00
    bxb100
        1
    bxb100  
       288 天前 via Android   1
    一般都是外包写的…
    TyCoding
        2
    TyCoding  
       288 天前
    基本都是外包写的,甚至大部分产品都是外包写的
    potatowish
        3
    potatowish  
       288 天前 via iPhone
    奇怪难道别家文档不是外包写吗,国内腾讯的文档相对来说挺清晰的
    laikicka
        4
    laikicka  
       287 天前
    @potatowish 腾讯的文档还清晰? 老中公司的文档都藏着捏着.
    wencan
        5
    wencan  
    OP
       287 天前
    @laikick 哪家文档没毛病?相对来说,腾讯的文档还算清晰,毕竟那么多开发者接入
    福报厂的文档,明显已经不是毛病不毛病,清晰不清晰的问题了
    laikicka
        6
    laikicka  
       287 天前
    @wencan 国外的公司就开放清晰. 都不用注册随便看 老中的看个文档都恨不得要你实名制
    luckyrayyy
        7
    luckyrayyy  
       287 天前
    倒排工期没空写,人力不足召唤外包,每年换三波人维护,以上就是大厂常态。
    donaldturinglee
        8
    donaldturinglee  
       287 天前
    有时候根本不知道该怎么调接口和传参数. 写的 UML 也是云里雾里
    yikyo
        9
    yikyo  
       287 天前 via iPhone
    没几个平台 API 写的不错,没记错的话微信支付有个大小写参数的问题,第一次对接很容易掉坑,网易 im ,风格不统一,有直接返回的,有回调返回的,没有固定参数格式,很明显是好几波人维护后的结果
    wceozl
        10
    wceozl  
       287 天前
    有幸做过钉钉小程序,api 全靠微信小程序文档和自己猜
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     5372 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 24ms UTC 06:58 PVG 14:58 LAX 23:58 JFK 02:58
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86