runnerlee
V2EX  ›  PHP

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

  •  
  •   runnerlee · Jan 7, 2019 · 5937 views
    This topic created in 2711 days ago, the information mentioned may be changed or developed.

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

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

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