PTT推薦

[請益] 有人的公司也沒有提供API文件的嗎

看板Soft_Job標題[請益] 有人的公司也沒有提供API文件的嗎作者
cv123741
(cv123741)
時間推噓34 推:34 噓:0 →:38

安安

小弟剛轉前端,進到一家接案公司寫網頁,工作大概9成都在接API,
但公司內部沒有提供api規格文件讓我參考,
導致每次我都要通靈,
不然就是纏著後端不放,

「溝通」大概佔了我1/3到1/2的開發時間,

公司雖然有說以後會要求有文件,但遲遲沒下文...


有沒有人也遇過同樣問題的,這樣要如何解決?

還是只能出下下策直接離職比較省事
----
Sent from BePTT on my iPhone 11

--

※ PTT 留言評論
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 112.78.88.96 (臺灣)
PTT 網址

frank3094101/01 19:28快逃啊

alihue01/01 19:29問就是逃

samioplg01/01 19:34連swagger都沒有就是快逃

k79897686901/01 19:36同上

rodion01/01 19:58可以的話 就改用GraphQL吧

WaterLengend01/01 20:06逃吧

loadingN01/01 20:14離職是是上上策

w723612601/01 20:18API文件很基本 沒有還敢做?!

Belieeve01/01 21:07API沒文件那至少訂定API前端也要參與API的討論

Belieeve01/01 21:08不然QA有事都找前端,然後你一追又是API問題,還要負責

Belieeve01/01 21:08說服後端改,會非常心累

現在進行式 哭啊

labbat01/01 21:27開會紀錄就是文件啊,要API規格去看信件串即可

沒開會紀錄、公司信箱,有東西可以參考算我賺到

labbat01/01 21:27寫文件很麻煩呀,而且寫了不一定是對的

sakyle01/01 21:28我這邊相反耶,API文件寫的圖文並茂還是被巴著問

pig8800301/01 21:31回樓上API寫的很清楚但有時QA問做確認很正常吧…

KY199801/01 21:42沒API文件叫後端全包

imhaha01/01 21:47拿到api文件發現是參考用的才吐血吧

wei11501/01 21:52有R 現在開發的東西就沒API參考 也沒註釋 就一個API名稱可

wei11501/01 21:53以看 好一點的有原始碼 可以邊寫邊參考datasheet的暫存器

wei11501/01 21:54來推測功能是什麼(順便發現bug 照他這樣寫不會動) 壞一

wei11501/01 21:55點的就全部包在*.a檔裡面 link進去的 就通靈幻想功能是什

wei11501/01 21:55

找到前輩了 可惜我連原始碼都沒

wei11501/01 21:56解決方法就是全文搜尋 看有沒有其他程式用到這API 他是怎

wei11501/01 21:57麼用的 還有最近發現 把殘缺的扣丟給chatGPT 他通靈很厲害

agogoman01/01 22:08沒文件就算了, 我還遇過沒原始碼的, 只有一個孤單的dll

Merkle01/01 22:33API沒文件你怎麼知道怎麼call?

不能透露太多,怕被認出來,9成靠通靈

kissmickey01/01 22:41說真的一堆專案一手轉一手 交接沒完全真的要通靈 遇

kissmickey01/01 22:41到這種如果是通例快走啊

kissmickey01/01 22:43專案都不寫文件的公司建議快閃

kissmickey01/01 22:45一般開發文件設計規格 維護變更需求文件不是都很基本

s00158200001/01 22:50我都是畫面做功能 做出來主管再說哪邊要改

s00158200001/01 22:54原本以為這樣管理很糟糕 但後來想想離職也都不用交接

s00158200001/01 22:54 其實頗爽

kissmickey01/01 22:56是滿爽的 只是後人會靠北 不然就是有屎都往前人潑

viper970901/01 23:32通靈王大戰XD

somefatguy01/02 00:06我最近接公司某個產品的API,雖然有文件但都英文

somefatguy01/02 00:06重點不是英文,而是英文都錯的看不懂在寫三小

somefatguy01/02 00:08還有公司code註解也一堆不知寫三小的英文

somefatguy01/02 00:08每次我都想幹嘛不寫中文

as3038543801/02 00:17接案公司就不用期待了吧,功有練到就早點跳了

neo527701/02 00:47swagger這麼好用.....

neo527701/02 00:47前端都這樣給我們json後面就我們套出來給他這樣

now9901/02 01:34沒文件欄位亂改不就慘了

還沒上線 所以還好

holebro01/02 02:01孤單dll xdd好克難

jinmin8801/02 09:05直接跟主管講 看他怎麼處理後端

主管也知道 是公司沒要求

cplusplus42601/02 10:23你面試有問 主管說有? 結果沒有?

maxjoiny01/02 10:46請他們安裝swagger

OriginStar01/02 11:42寫API文件要花時間,接案也要花時間。寫API文件不會增

OriginStar01/02 11:43加營收,接案可以增加營收。公司應該覺得花時間寫API

OriginStar01/02 11:44文件,不如多接案,反正員工免洗

BigCockman01/02 12:20還好吧 更多接案公司都嗎一人包前後端 直接不用浪費

BigCockman01/02 12:20時間寫文件 反正案子做得出來就好了

lairx01/02 12:34問就是逃

※ 編輯: cv123741 (112.78.88.96 臺灣), 01/02/2023 12:51:15

newbout01/02 13:25接案公司尤其是小的的話感覺蠻正常的

jobintan01/02 14:49沒文檔就是大雷包。

TakiDog01/02 17:31隕石開發,只用Postman collocation + example

TakiDog01/02 17:32反而比swagger還方便些

TakiDog01/02 17:32collocation(X collection(O

henry671501/02 18:21很多小公司會這樣,啥都沒有,通靈大戰xd

firtaily01/02 18:30有文件 文件還不一定對

Killercat01/02 22:54API文件用gen的,不要用寫的。用寫的大家都不會更新他

Killercat01/02 22:54用gen的話 格式一改馬上就能反映到文件上

leolarrel01/03 12:50tdd領域的人會說測試就是文件

knives01/03 16:45

dong53101/03 16:55小公司小專案正常,而且有文件沒有比較好,遇過有文件但

dong53101/03 16:55是萬年沒更新,跑去問結果叫你順便更新文件

xoy23201/03 21:11待過小公司 真的都沒有 逃或通靈

JIKUAI01/04 00:29swagger或postman 至少要一個吧,不然就換家公司

audy01/04 12:29這樣要怎麼接API阿,扯爆

hn8490803301/05 00:50有文件但不一定是對的 會更雷...

crwu01/05 01:15領導沒有嚴格落實這個基礎的文件有 是領導的責任

CoNsTaR01/05 04:30Idris: 測試是啥?Type 就是文件