V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
runnerlee
V2EX  ›  PHP

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

  •  
  •   runnerlee · 2019-01-07 14:49:21 +08:00 · 5142 次点击
    这是一个创建于 2139 天前的主题,其中的信息可能已经有所发展或是发生改变。

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

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

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