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

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

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

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

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

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