接口由誰(shuí)來(lái)設(shè)計(jì)更妥當(dāng)

近日循衰,看了篇文章,名為《一篇來(lái)自前端同學(xué)對(duì)后端接口的吐槽》勉失,閱后羹蚣,頗有感觸。

在文中乱凿,這個(gè)槽吐得犀利顽素,甚合吾意。作者開(kāi)篇就拋出了自己的觀點(diǎn):究竟接口應(yīng)該由誰(shuí)來(lái)設(shè)計(jì)徒蟆?是接口的消費(fèi)者胁出,還是接口的提供者?消費(fèi)者就是使用并展現(xiàn)接口數(shù)據(jù)的前端人員段审,對(duì)應(yīng)的提供者則是后端人員全蝶。

通常接口的定義是由后端人員來(lái)設(shè)計(jì),這樣建庫(kù)寺枉、建表也方便抑淫,一條路就走下去了。設(shè)計(jì)完之后呢姥闪,就丟給前端去用始苇,后端不用,就如文中提到的“好比一個(gè)從來(lái)不嘗自己做的菜的廚子筐喳,你指望他的菜能好到哪里去催式,他的廚藝能好到哪里去?”避归,這就很有可能導(dǎo)致設(shè)計(jì)出來(lái)的接口不好用荣月。

我待過(guò)的都是小公司,大公司的情況是什么樣梳毙,沒(méi)待過(guò)哺窄,不清楚,沒(méi)有發(fā)言權(quán)。做為一個(gè)小公司萌业,我們沒(méi)有架構(gòu)師蔑担,接口也都是由后端的哥們?cè)O(shè)計(jì),因?yàn)槔习逭J(rèn)為由后端人員來(lái)設(shè)計(jì)接口咽白,項(xiàng)目有保障,前端的人員不懂后臺(tái)鸟缕,不能設(shè)計(jì)晶框;做為我們前端也認(rèn)為,前端設(shè)計(jì)出來(lái)的接口字段還得要后端來(lái)實(shí)現(xiàn)懂从,不知對(duì)后端的數(shù)據(jù)結(jié)構(gòu)有什么影響授段,是不是數(shù)據(jù)庫(kù)不好架構(gòu),表是不是不好設(shè)計(jì)番甩,到時(shí)候侵贵,實(shí)現(xiàn)不了也是白費(fèi)。因此缘薛,由后端來(lái)設(shè)計(jì)接口也是件水到渠成的事兒窍育。

由提供者設(shè)計(jì)接口其實(shí)沒(méi)有什么不妥,只要你別站在開(kāi)發(fā)者的角度來(lái)想問(wèn)題宴胧。

在實(shí)際項(xiàng)目中調(diào)用接口時(shí)漱抓,我的體會(huì)是太難用了,接口里什么數(shù)據(jù)都有恕齐。獲取文章的信息乞娄,連作者的用戶(hù)信息都有,而且信息還非常之全显歧,什么用戶(hù)的創(chuàng)建時(shí)間仪或、用戶(hù)的權(quán)限標(biāo)識(shí)、用戶(hù)名的修改時(shí)間......士骤,不光這樣范删,獲取的文章信息里,還有幾個(gè)空字段敦间,都是數(shù)據(jù)庫(kù)里預(yù)留的瓶逃。看起來(lái)廓块,接口數(shù)據(jù)要嘛有嘛厢绝,可前端從接口中抽取的有用信息,經(jīng)常都不到一半带猴,造成了極大的帶寬浪費(fèi)昔汉。我只要小而美,你給我弄了個(gè)大而全。

相比大而全靶病,更煎熬的是会通,接口返回的數(shù)據(jù),你前端不能直接用娄周,得二次加工涕侈。用一個(gè)for循環(huán),根據(jù)某個(gè)字段id煤辨,把獲取的數(shù)據(jù)全部或部分地篩選一遍裳涛,重新組織出一個(gè)新數(shù)據(jù)集來(lái),最終展現(xiàn)的是這個(gè)新數(shù)據(jù)集众辨,而不是接口給的數(shù)據(jù)端三。

有時(shí),在另外一個(gè)場(chǎng)景需要數(shù)據(jù)時(shí)鹃彻,提供者會(huì)跟你說(shuō):“你調(diào)之前那個(gè)接口就行郊闯,里邊有數(shù)據(jù),你自己摘一下蛛株⊥帕蓿”

累啊,而且這種情形還經(jīng)常在你眼前出現(xiàn)谨履。

最后然痊,借用文中作者的話(huà)做個(gè)總結(jié)吧:“API和代碼應(yīng)該是精準(zhǔn)的,準(zhǔn)確表達(dá)你想實(shí)現(xiàn)的一切而不存在有歧義屉符。一個(gè)接口本應(yīng)該就專(zhuān)注一件事情剧浸。”

?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
  • 序言:七十年代末矗钟,一起剝皮案震驚了整個(gè)濱河市唆香,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌吨艇,老刑警劉巖躬它,帶你破解...
    沈念sama閱讀 219,039評(píng)論 6 508
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異东涡,居然都是意外死亡冯吓,警方通過(guò)查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 93,426評(píng)論 3 395
  • 文/潘曉璐 我一進(jìn)店門(mén)疮跑,熙熙樓的掌柜王于貴愁眉苦臉地迎上來(lái)组贺,“玉大人,你說(shuō)我怎么就攤上這事祖娘∈Ъ猓” “怎么了?”我有些...
    開(kāi)封第一講書(shū)人閱讀 165,417評(píng)論 0 356
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)掀潮。 經(jīng)常有香客問(wèn)我菇夸,道長(zhǎng),這世上最難降的妖魔是什么仪吧? 我笑而不...
    開(kāi)封第一講書(shū)人閱讀 58,868評(píng)論 1 295
  • 正文 為了忘掉前任庄新,我火速辦了婚禮,結(jié)果婚禮上薯鼠,老公的妹妹穿的比我還像新娘摄咆。我一直安慰自己,他們只是感情好人断,可當(dāng)我...
    茶點(diǎn)故事閱讀 67,892評(píng)論 6 392
  • 文/花漫 我一把揭開(kāi)白布。 她就那樣靜靜地躺著朝蜘,像睡著了一般恶迈。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上谱醇,一...
    開(kāi)封第一講書(shū)人閱讀 51,692評(píng)論 1 305
  • 那天暇仲,我揣著相機(jī)與錄音,去河邊找鬼副渴。 笑死奈附,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的煮剧。 我是一名探鬼主播斥滤,決...
    沈念sama閱讀 40,416評(píng)論 3 419
  • 文/蒼蘭香墨 我猛地睜開(kāi)眼,長(zhǎng)吁一口氣:“原來(lái)是場(chǎng)噩夢(mèng)啊……” “哼勉盅!你這毒婦竟也來(lái)了佑颇?” 一聲冷哼從身側(cè)響起,我...
    開(kāi)封第一講書(shū)人閱讀 39,326評(píng)論 0 276
  • 序言:老撾萬(wàn)榮一對(duì)情侶失蹤草娜,失蹤者是張志新(化名)和其女友劉穎挑胸,沒(méi)想到半個(gè)月后,有當(dāng)?shù)厝嗽跇?shù)林里發(fā)現(xiàn)了一具尸體宰闰,經(jīng)...
    沈念sama閱讀 45,782評(píng)論 1 316
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡茬贵,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 37,957評(píng)論 3 337
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了移袍。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片解藻。...
    茶點(diǎn)故事閱讀 40,102評(píng)論 1 350
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖葡盗,靈堂內(nèi)的尸體忽然破棺而出舆逃,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 35,790評(píng)論 5 346
  • 正文 年R本政府宣布路狮,位于F島的核電站虫啥,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏奄妨。R本人自食惡果不足惜涂籽,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 41,442評(píng)論 3 331
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望砸抛。 院中可真熱鬧评雌,春花似錦、人聲如沸直焙。這莊子的主人今日做“春日...
    開(kāi)封第一講書(shū)人閱讀 31,996評(píng)論 0 22
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)奔誓。三九已至斤吐,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間厨喂,已是汗流浹背和措。 一陣腳步聲響...
    開(kāi)封第一講書(shū)人閱讀 33,113評(píng)論 1 272
  • 我被黑心中介騙來(lái)泰國(guó)打工, 沒(méi)想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留蜕煌,地道東北人派阱。 一個(gè)月前我還...
    沈念sama閱讀 48,332評(píng)論 3 373
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像斜纪,于是被迫代替她去往敵國(guó)和親贫母。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 45,044評(píng)論 2 355