該怎樣設計API

2021-10-09 07:38:47 字數 460 閱讀 5223

api定義哲學:要站在使用者的角度定義介面,哪怕背後對應技術實現方式難度更大。我們應該把這些dirty laundry隱藏在api背後。而不是選擇一條自己更容易實現的技術方式,卻把dirty laundry都拋給了你的使用者

再次強調api定義哲學:當我們給使用者提供api時,不應該由技術實現的難易程度來決定,而是站在使用者的角度,消除掉一切不必要的複雜度,讓使用者可以最快速,最直接的達到他的目的

至於實現時的細節和複雜度,都應該統統被隱藏在api的背後。

首先站在客戶的角度思考,怎樣才是客戶真正的需要。此時完全不考慮技術實現的方式。

得到乙個理想的api後,然後再去尋找一切可能的方式去實現api。

當碰到困難時,有兩種解決辦法:

看看存不存在更容易實現的另外一種等價形式。注意,這種等價形式和原來對比,依然不會增加任何使用者的負擔。

try harder。此時正是走出舒適區,拓展知識面,發揮創造力的最佳時機。

摘抄 IT公司該怎樣工作

1.專案 產品的成功,尤其是傑出的產品,都離不開公司對來自客戶 內部 合作夥伴的許許多多任務作負載進行深入觀察的經驗體會。所以公司除了把專案產品交付給客戶作反饋與交流,有條件的話應該深刻理解客戶 內部 合作夥伴的感受。2.開發經理要清楚每個開發成員的技術特點 特長 性格特點。3.分析 總結公司專案,...

網域名稱該怎樣選 爸爸們都想買的MPV該怎樣選?

我入手燃油版奧德賽已經有5年,雖然不是跑得最多的車,但卻是家庭最重要的座駕。最近不少朋友都來諮詢mpv的選購事宜,我也總結了大家提到的一些疑問,這次好好聊聊吧!mpv和suv該怎樣選?到底選七座suv還是mpv,這是許多家庭使用者在選車時都會遇上的問題,絕大多數朋友會傾向前者,它擁有更好的通過性,也...

服務API設計 之 API設計原則

對接xx業務時,xx業務具備的功能和api全靠跑業務負責人那反覆逐個詢問 確認。用哪個api 怎麼用 有沒有限制 等等 各個業務間,甚至同一業務內,api風格不統一。xx業務api效能方面未知。隨著業務的演進,開放的api持續在增加,但類同的很多 api編碼規範迫在眉睫 自解釋 易學習 易使用 難誤...