楼主:
cv123741 (cv123741)
2023-01-01 19:11:08安安
小弟刚转前端，进到一家接案公司写网页，工作大概9成都在接API，
但公司内部没有提供api规格文件让我参考，
导致每次我都要通灵，
不然就是缠着后端不放，
“沟通”大概占了我1/3到1/2的开发时间，
公司虽然有说以后会要求有文件，但迟迟没下文...
有没有人也遇过同样问题的，这样要如何解决？
还是只能出下下策直接离职比较省事
作者: frank30941 (frank30941) 2023-01-01 19:28:00
快逃啊
作者:
alihue (wanda wanda)
2023-01-01 19:29:00问就是逃
作者: k798976869 (kk) 2023-01-01 19:36:00
同上
作者:
rodion (r-kan/reminder)
2023-01-01 19:58:00可以的话 就改用GraphQL吧
作者:
loadingN (sarsaparilla)
2023-01-01 20:14:00离职是是上上策
作者: w7236126 2023-01-01 20:18:00
API文件很基本 没有还敢做？！
作者: Belieeve (芥末拿铁) 2023-01-01 21:07:00
API没文件那至少订定API前端也要参与API的讨论不然QA有事都找前端，然后你一追又是API问题，还要负责说服后端改，会非常心累
作者:
labbat (labbat)
2023-01-01 21:27:00开会纪录就是文件啊，要API规格去看信件串即可写文件很麻烦呀，而且写了不一定是对的
作者:
sakyle (Sakyle)
2023-01-01 21:28:00我这边相反耶，API文件写的图文并茂还是被巴著问
回楼上API写的很清楚但有时QA问做确认很正常吧…
作者:
KY1998 (HAN)
2023-01-01 21:42:00没API文件叫后端全包
作者:
imhaha (嘿嘿)
2023-01-01 21:47:00拿到api文件发现是参考用的才吐血吧
作者:
wei115 (ㄎㄎ)
2023-01-01 21:52:00有R 现在开发的东西就没API参考 也没注释 就一个API名称可以看 好一点的有原始码 可以边写边参考datasheet的暂存器来推测功能是什么（顺便发现bug 照他这样写不会动） 坏一点的就全部包在*.a档里面 link进去的 就通灵幻想功能是什么解决方法就是全文搜寻 看有没有其他程式用到这API 他是怎么用的 还有最近发现 把残缺的扣丢给chatGPT 他通灵很厉害
作者:
agogoman (cocorosie)
2023-01-01 22:08:00没文件就算了, 我还遇过没原始码的, 只有一个孤单的dll
作者:
Merkle (你在想奇怪的东西齁)
2023-01-01 22:33:00API没文件你怎么知道怎么call?
说真的一堆专案一手转一手 交接没完全真的要通灵 遇到这种如果是通例快走啊专案都不写文件的公司建议快闪一般开发文件设计规格 维护变更需求文件不是都很基本
我都是画面做功能 做出来主管再说哪边要改原本以为这样管理很糟糕 但后来想想离职也都不用交接其实颇爽
作者: somefatguy 2023-01-02 00:06:00
我最近接公司某个产品的API，虽然有文件但都英文重点不是英文，而是英文都错的看不懂在写三小还有公司code注解也一堆不知写三小的英文每次我都想干嘛不写中文
作者:
neo5277 (I am an agent of chaos)
2023-01-02 00:47:00swagger这么好用.....前端都这样给我们json后面就我们套出来给他这样
作者:
now99 (陈在天)
2023-01-02 01:34:00没文件字段乱改不就惨了
作者:
holebro (穴弟弟)
2023-01-02 02:01:00孤单dll xdd好克难
写API文件要花时间，接案也要花时间。写API文件不会增加营收，接案可以增加营收。公司应该觉得花时间写API文件，不如多接案，反正员工免洗
还好吧 更多接案公司都吗一人包前后端 直接不用浪费时间写文件 反正案子做得出来就好了
作者:
lairx (lairx)
2023-01-02 12:34:00问就是逃
作者:
newbout ( nb 但没有 a )
2023-01-02 13:25:00接案公司尤其是小的的话感觉蛮正常的
作者:
jobintan (Robin Artemstein)
2023-01-02 14:49:00没文档就是大雷包。
作者:
TakiDog (多奇狗)
2023-01-02 17:31:00陨石开发，只用Postman collocation + example反而比swagger还方便些collocation(X collection(O
作者:
firtaily (firtaily)
2023-01-02 18:30:00有文件 文件还不一定对
API文件用gen的，不要用写的。用写的大家都不会更新他用gen的话 格式一改马上就能反映到文件上
作者:
knives 2023-01-03 16:45:00逃
作者:
dong531 (猫王)
2023-01-03 16:55:00小公司小专案正常，而且有文件没有比较好，遇过有文件但是万年没更新，跑去问结果叫你顺便更新文件
作者:
xoy232 (鬼岛希特勒)
2023-01-03 21:11:00待过小公司 真的都没有 逃或通灵
作者:
JIKUAI (听妈妈说)
2023-01-04 00:29:00swagger或postman 至少要一个吧，不然就换家公司
作者: audy (audy) 2023-01-04 12:29:00
这样要怎么接API阿，扯爆
作者: crwu 2023-01-05 01:15:00
领导没有严格落实这个基础的文件有 是领导的责任
作者:
CoNsTaR ((const *))
2023-01-05 04:30:00Idris: 测试是啥？Type 就是文件
作者: bboy81905 (庄家) 2023-01-05 12:11:00
model gen swagger, 轻轻松松后端建置～初期习惯一下就好了
作者:
ccc1001 (你不是吧)
2023-01-05 16:53:00就是公司思维了 除非主管换过一轮 建议快逃
作者: streakray (条纹衣boy) 2023-01-07 01:56:00
跟你很像，但是至少有文件，只是每个文件参差不齐
作者: superpandal 2023-01-08 19:40:00
这没办法 这是人的问题 不管是文件和swagger还是postman以及graphql都不能避免 文件写的差 api也可以写的差 api说明也可以写的差不过swagger类的工具要自己写也很简单 还可以自定义一些功能
作者:
acgotaku (otaku)
2023-01-09 20:32:00没api文件是真的雷 不是家里没主管 就是主管也一起打混这不是有没有纪律的问题 是根本不负责任的行为