看我遇到的奇葩: 联调接口不给文档直接微信发个控制器文件 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
runnerlee
V2EX    PHP

看我遇到的奇葩: 联调接口不给文档直接微信发个控制器文件

  •  
  •   runnerlee 2019 年 1 月 7 日 5707 次点击
    这是一个创建于 2574 天前的主题,其中的信息可能已经有所发展或是发生改变。

    跟个同事联调个接口, 要了下文档, 结果直接发个控制器文件是什么操作?

    31 条回复    2019-01-08 09:46:43 +08:00
    e9e499d78f
        1
    e9e499d78f  
       2019 年 1 月 7 日   8
    最好的文档就是代码本身
    ---- 鲁迅
    IsaacYoung
        2
    IsaacYoung  
       2019 年 1 月 7 日 via iPhone
    要么忍
    rxzxf1993
        3
    rxzxf1993  
       2019 年 1 月 7 日
    我感觉是在黑 php
    kkkkkrua
        4
    kkkkkrua  
       2019 年 1 月 7 日   2
    我 TM 什么都说过
    --鲁迅
    runnerlee
        5
    runnerlee  
    OP
       2019 年 1 月 7 日
    @rxzxf1993 老哥我也是个辣鸡 phper haha..
    geying
        6
    geying  
       2019 年 1 月 7 日
    一般发代码就是拿来能直接跑的吧
    xnode
        7
    xnode  
       2019 年 1 月 7 日
    php 是最好的语言 --- 鲁迅
    flowerains
        8
    flowerains  
       2019 年 1 月 7 日 via iPhone
    这还不骂回去,有这么连调的?
    runnerlee
        9
    runnerlee  
    OP
       2019 年 1 月 7 日
    @geying 虽然 php 是最好的语言, 但是也不能这么用.. 我们做的也不是同个项目.
    runnerlee
        10
    runnerlee  
    OP
       2019 年 1 月 7 日
    @flowerains 哈哈, 已怼
    phpcxy
        11
    phpcxy  
       2019 年 1 月 7 日   6
    反手发回一个文件,问『您看我这样对吗?』
    WytheHuang
        12
    WytheHuang  
       2019 年 1 月 7 日 via Android
    优秀
    Sylphiette
        13
    Sylphiette  
       2019 年 1 月 7 日
    公司项目,对接军方大佬,要 api 文档的时候,对面甩给我一份 EXCEL。。。
    实在恶心,对面又是大佬,用 markdown 重写了一份,甩了回去 = =
    之后 api 更新,都是我帮他们写 api 文档给我自己用
    tanszhe
        14
    tanszhe  
       2019 年 1 月 7 日
    他的意思是 你直接 rpc 远程调用他的方法就好了 自己不用写
    runnerlee
        15
    runnerlee  
    OP
       2019 年 1 月 7 日
    @tanszhe 我也想, 但实际情况是... 这里连内部 API 调用都是走公网 HTTP
    flyingghost
        16
    flyingghost  
       2019 年 1 月 7 日
    写完了。顺便,我发现你代码里有 4 个 bug。
    什么 bug ?
    你看这个。
    RefundController.php
    shyangs
        17
    shyangs  
       2019 年 1 月 7 日
    代码即文档

    ::doge::
    tongz
        18
    tongz  
       2019 年 1 月 7 日
    这是 PHP 被黑的最惨的一次.
    --鲁迅
    tydl
        19
    tydl  
       2019 年 1 月 7 日
    好歹还有代码,我们这一提接口,就是直接给数据库表~
    runnerlee
        20
    runnerlee  
    OP
       2019 年 1 月 7 日
    @flyingghost 人才啊老哥哈哈
    runnerlee
        21
    runnerlee  
    OP
       2019 年 1 月 7 日
    @tydl 证明你们规范做得好啊, CRUD 接口来来回回就那几个参数
    shawndev
        22
    shawndev  
       2019 年 1 月 7 日   2
    你这好歹是对方主动发给你的,我还遇到过代码都不肯看就瞎解释接口,我顶住压力自己翻服务端代码的。
    xnode
        23
    xnode  
       2019 年 1 月 7 日
    @Heimo 钱给够了,没啥问题
    BestSera
        24
    BestSera  
       2019 年 1 月 7 日
    不错了。。上上家公司问接口直接口头告诉你参数
    我:???
    passerbytiny
        25
    passerbytiny  
       2019 年 1 月 7 日
    正常,当老板让你 2 个星期完成一个项目时,能给你源码都不错了。
    byteli
        26
    byteli  
       2019 年 1 月 7 日
    我们一般就口口相传,一直想知道维护接口文档是怎么样的体验,感觉要花开发 1/3 的时间来写文档
    wpo
        27
    wpo  
       2019 年 1 月 7 日
    想起了上次我同学入职一家写 iOS,Android 的同事叫他自己抓包一下接口来写。
    winglight2016
        28
    winglight2016  
       2019 年 1 月 7 日
    @tydl 给数据库的意思是,自己开发一套 API 自用吗?(狗头
    yimity
        29
    yimity  
       2019 年 1 月 7 日
    我还遇到过让我看数据库设计文件的呢。
    vision4fun
        30
    vision4fun  
       2019 年 1 月 8 日 via iPhone
    老哥说 talk is cheap 并甩给你一段源代码
    runnerlee
        31
    runnerlee  
    OP
       2019 年 1 月 8 日
    @shawndev 也是, 想想也挺不错的
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     894 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 27ms UTC 21:38 PVG 05:38 LAX 13:38 JFK 16:38
    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