公司規定所有介面都用 post 請求,這正確麽?

来源:https://www.cnblogs.com/dotnet-college/archive/2023/01/29/17073634.html
-Advertisement-
Play Games

目錄 背景 get 與 post 的區別 所有介面都用 post 請求? 背景 最近在逛知乎的時候發現一個有趣的問題:公司規定所有介面都用 post 請求,這是為什麼? 看到這個問題的時候其實我也挺有感觸的,因為我也曾經這樣問過我自己。在上上一家公司的時候接到一個項目是從零開始搭建一個微服務,當時就 ...


目錄

  • 背景
  • get 與 post 的區別
  • 所有介面都用 post 請求?

背景

最近在逛知乎的時候發現一個有趣的問題:公司規定所有介面都用 post 請求,這是為什麼?

看到這個問題的時候其實我也挺有感觸的,因為我也曾經這樣問過我自己。在上上一家公司的時候接到一個項目是從零開始搭建一個微服務,當時就有瞭解過介面的一些規範,比如耳熟能詳的 Restful 規範,就被應用到這個微服務項目中。

get 與 post 的區別

今天再次看到這個問題,我也有了一些新的理解和感觸,臨時回顧了一下 get 與 post 的請求的一些區別。

如下:

  • post 更安全(不會作為 url 的一部分,不會被緩存、保存在伺服器日誌、以及瀏覽器瀏覽記錄中)
  • post 發送的數據更大(get 有 url 長度限制)
  • post 能發送更多的數據類型(get 只能發送 ASCII 字元)
  • post 比 get 慢
  • post 用於修改和寫入數據,get 一般用於搜索排序和篩選之類的操作
  • get 請求的是靜態資源,則會緩存,如果是數據,則不會緩存

查看上面的區別,就會發現 post 在發送數據量大的請求時優勢很明顯,get 則更適合獲取靜態資源、簡單的查詢等介面。

我個人在開發介面的時候也會註意,將簡單的查詢請求使用 get 方法,其他增、刪、改、複雜的查詢請求都可以使用 post,但不會像題主的公司一樣全部使用 post。

所有介面都用 post 請求?

網友程墨 Morgan

網友程墨 Morgan 提出如果是自己會按照『業界最佳實踐』制定規範:

 

網友蘇莉安

另外一個知友提出:就是為了遷就低水平不思進取的架構師和前後端程式員們。

 

網友大寬寬

大寬寬的回答:我打算跳出技術的範疇,從 ROI 的角度討論下如果一個架構風格(比如  Restful)真的那麼好,為啥應用上沒有那麼廣泛?

首先要明確,不管你多麼喜歡技術,無論是這裡說的一個 http 的 method,又或者是編程語言的一些用法、架構設計方法、甚至是 OKR 這樣的管理和溝通的方法。這一切,都是為了滿足企業對市場的需求。

簡單來說,公司給你發工資,不是為了讓你遵守規範的,而是為了能在成本可接受的情況下,讓業務落地。而其中,一般情況下,介面的形式是個微不足道的局部問題。

對於企業來講,技術團隊要解決的更重要的問題:

  • 是理解業務模型,形成業務架構和可以穩定跑的系統;
  • 是面對大量涌入用戶對系統可用性的要求對系統不會卡頓掛機的擴展性保障;
  • 是不會動不動抽瘋一下,丟條數據或者數據衝突的穩定性要求,以及為了達成這些要求給監控體系的各種便利。

但一定要糾結下 POST/GET,以及 Restful。好吧,Restful 能明確列出來的好處,就那麼幾點(如果有疏漏的請在評論區里補充)。

如下:

  • 表達不同的業務動作語義:GET/POST/PATCH/PUT/DELETE……,
  • 表達“資源”的概念利用
  • url path,querystring,header,status code 等來表達很多介面功能
  • 以上兩條可以達成一種“統一”的介面表達形式,以至於可以圍繞這個形式實現介面維護的工具,比如 swagger。
  • Get 資源可以利用緩存

但代價是什麼?

①強行的統一,讓本來天然不是資源的業務概念也一定要強行“資源“一下,引發了更多的理解不一致和溝通困難。

當然,事物總是可以“抽象”一下,業務概念抽象為“資源”很多時候都是可行的。但這這麼做的收益除了證明“一個人聰明,有不錯的抽象能力“,以及“更容易利用上 swagger 一類的工具“之外,我看不到啥額外的短期或者長期收益。

②亂折騰 path,querysting 等東西,讓橫切麵治理抓取關鍵信息更難了。 比如監控時抓一個 path 裡帶變數的 url 是非常噁心的事情。

又或者看到一個 404 的報警,卻根本搞不清楚到底是服務部署有問題;還是服務正常,但用戶不存在;又或者是用戶存在,但用戶訂單不存在。帶來的問題是運營工具編寫困難,線上問題響應能力會被降低。

③即使使用 swagger,還是需要寫說明和文檔來說明其業務語義。 介面工具應該提供的“好理解,介面改了後文檔自動生成”等好處,只有在介面反應的資源剛好和後臺數據表/視圖能夠對應上才有效。

也就是說只適合介面層級低的場景下有用,而對高層介面意義不大。結果開發者既要用 swagger 這樣的工具,同時還是要看常規文檔。本來用一套機制可以解決的問題要改成兩套。

④Cache 雖好,但最怕的是管控不到位讓用戶拿到了過期數據。 對於 Cache,業務上一般會區分動態介面和靜態介面。

前者預設不應該有 cache,所以用了 Get 之後為了防範,還得手工在大部分動態介面上加 Cache-Control: no-cache,或者動態產生 ETag(浪費 CPU)。而後者一般會採用 CDN,這一套針對 cache 做了很精巧的設計。

⑤使用形式各異的 method 和 url path,querystring 上做各種奇怪的拼接,會給前端帶來巨大的困擾。

因為本來一個函數調用,還得翻譯一遍,活生生的弄出來一個介面翻譯層。妥妥的降低人效。如果是 web,iOS,Android 三套前端,就得弄 3 個介面翻譯層。

⑥非 GET 和 POST 之外的 method 有可能會被不恰當的網關轉發規則給幹掉。 為此 Restful 還是搞出了 method override 這樣的招數……

所以到底適不適合,落地時聽罵聲和吵架聲就知道了。

有人舉了 Google S3 運用 Restful 介面的例子來說明其正確性。但 S3 是乾什麼的大家都懂,S3 天然就是用來存取“資源“的。

一個工具用在了恰當場景,當然是“正確“的。S3 用的好的東西,只能說明類似的阿裡雲 OSS,騰訊雲 COS 也可以這麼乾。但無法證明電商業務、社交業務、I 醫療業務、政企辦公協同……這些業務也適合這麼乾。

而作為技術負責人,如果他搞出了一套介面方案(也許其中一條就是所有 http 介面都用 post),提高了開發效率,降低了溝通成本,降低了運維和錯誤定位成本,為企業真正做到了降本增效。

把瞎折騰的成本,投入到了其他比如業務架構設計,測試體系,線上監控,容災降級等領域上。

最終讓企業(用戶需求得到滿足,收入增加)和員工得到了收益(因為公司收入增加而漲薪)。

我會評價這樣的人為“真正懂架構,懂技術,善於用技術解決實際問題。水平不知道高到哪裡去了”。

如果一個技術負責人只知道遵守一個書上寫的,但從沒驗證過在自己的環境有效的方案,以至於讓企業的核心目標無法達成。他就是趙括,該馬上捲鋪蓋捲走人。

至於我司,使用的規範是:

對於動態業務介面,只有一個介面 POST/action,在 Header 里給 X-Action 給出具體的介面名稱交給網關路由,session 表示用戶登錄身份,以及用於推薦、防重、染色、安全用到的各種 token/簽名。

所有的業務請求參數都以 PB 編碼後放在請求體里,並和後端的 gRPC 體系銜接。介面除了防重試之外,不提供常規意義上的 Cache。

而對於靜態介面,走 CDN,做多級 Cache。該用 Get 用 Get。如果一個動態介面也想利用 http 層 Cache,可以向網關申請和配置。有沒有 Cache,cache 多久是網關和端上自己實施的,完全自己管控。

各位讀者可以參考看看,並根據自己所處的業務場景和前後端交互思考下“我們目前用的技術規範是性價比最高的嗎,是最合適的嗎?“

如果是你來設計公司的 API 規範,會規定所有介面都用 post 請求嗎?


您的分享是我們最大的動力!

-Advertisement-
Play Games
更多相關文章
  • 1. 基礎知識 1.1 基本配置 main # 全局配置 events { # nginx 工作模式配置 } http { # http 設置 .... server { # 伺服器主機配置 .... location { # 路由配置 .... } location path { .... } l ...
  • 本文結合京東監控埋點場景,對解決樣板代碼的技術選型方案進行分析,給出最終解決方案後,結合理論和實踐進一步展開。通過關註文中的技術分析過程和技術場景,讀者可收穫一種樣板代碼思想過程和解決思路,並對Java編譯器底層有初步瞭解。 ...
  • 在golang中可以使用a := b這種方式將b賦值給a,只有當b能進行深拷貝時a與b才不會互相影響,否則就需要進行更為複雜的深拷貝。 下麵就是Go賦值操作的一個說明: Go語言中所有賦值操作都是值傳遞,如果結構中不含指針,則直接賦值就是深度拷貝;如果結構中含有指針(包括自定義指針,以及切片,map ...
  • 第一種方式:使用{} firstDict = {"name": "wang yuan wai ", "age" : 25} 說明:{}為創建一個空的字典對象 第二種方式:使用fromkeys()方法 second_dict = dict.fromkeys(("name", "age")) #valu ...
  • 如果您想查找高於或低於平均值的數字,可以不必計算該平均值,就能查看更高或更低的值。通過Java應用程式,可以自動突出顯示這些數字。除了快速突出顯示高於或低於平均值的值外,您還可以查看高於或低於的值的個數。現在讓我們看看如何在 Java應用程式中實現此操作。 引入jar包 導入方法1: 手動引入。將  ...
  • 幾乎所有的高級編程語言都有自己的垃圾回收機制,開發者不需要關註記憶體的申請與釋放,Python 也不例外。Python 官方團隊的文章 https://devguide.python.org/internals/garbage-collector 詳細介紹了 Python 中的垃圾回收演算法,本文是這篇 ...
  • 在新版本的pandas中,上述代碼會引起警告,建議改成SQLAlchemy connectable(engine/connection),後續代碼將引入這種升級的連接方式。 ...
  • *以下內容為本人的學習筆記,如需要轉載,請聲明原文鏈接 微信公眾號「englyf」https://mp.weixin.qq.com/s/2GFLTstDC7w6u3fTJxflNA 本文大概 1685 個字,閱讀需花 6 分鐘內容不多, 但也花了一些精力如要交流, 歡迎關註我然後評論區留言 謝謝你的 ...
一周排行
    -Advertisement-
    Play Games
  • Timer是什麼 Timer 是一種用於創建定期粒度行為的機制。 與標準的 .NET System.Threading.Timer 類相似,Orleans 的 Timer 允許在一段時間後執行特定的操作,或者在特定的時間間隔內重覆執行操作。 它在分散式系統中具有重要作用,特別是在處理需要周期性執行的 ...
  • 前言 相信很多做WPF開發的小伙伴都遇到過表格類的需求,雖然現有的Grid控制項也能實現,但是使用起來的體驗感並不好,比如要實現一個Excel中的表格效果,估計你能想到的第一個方法就是套Border控制項,用這種方法你需要控制每個Border的邊框,並且在一堆Bordr中找到Grid.Row,Grid. ...
  • .NET C#程式啟動閃退,目錄導致的問題 這是第2次踩這個坑了,很小的編程細節,容易忽略,所以寫個博客,分享給大家。 1.第一次坑:是windows 系統把程式運行成服務,找不到配置文件,原因是以服務運行它的工作目錄是在C:\Windows\System32 2.本次坑:WPF桌面程式通過註冊表設 ...
  • 在分散式系統中,數據的持久化是至關重要的一環。 Orleans 7 引入了強大的持久化功能,使得在分散式環境下管理數據變得更加輕鬆和可靠。 本文將介紹什麼是 Orleans 7 的持久化,如何設置它以及相應的代碼示例。 什麼是 Orleans 7 的持久化? Orleans 7 的持久化是指將 Or ...
  • 前言 .NET Feature Management 是一個用於管理應用程式功能的庫,它可以幫助開發人員在應用程式中輕鬆地添加、移除和管理功能。使用 Feature Management,開發人員可以根據不同用戶、環境或其他條件來動態地控制應用程式中的功能。這使得開發人員可以更靈活地管理應用程式的功 ...
  • 在 WPF 應用程式中,拖放操作是實現用戶交互的重要組成部分。通過拖放操作,用戶可以輕鬆地將數據從一個位置移動到另一個位置,或者將控制項從一個容器移動到另一個容器。然而,WPF 中預設的拖放操作可能並不是那麼好用。為瞭解決這個問題,我們可以自定義一個 Panel 來實現更簡單的拖拽操作。 自定義 Pa ...
  • 在實際使用中,由於涉及到不同編程語言之間互相調用,導致C++ 中的OpenCV與C#中的OpenCvSharp 圖像數據在不同編程語言之間難以有效傳遞。在本文中我們將結合OpenCvSharp源碼實現原理,探究兩種數據之間的通信方式。 ...
  • 一、前言 這是一篇搭建許可權管理系統的系列文章。 隨著網路的發展,信息安全對應任何企業來說都越發的重要,而本系列文章將和大家一起一步一步搭建一個全新的許可權管理系統。 說明:由於搭建一個全新的項目過於繁瑣,所有作者將挑選核心代碼和核心思路進行分享。 二、技術選擇 三、開始設計 1、自主搭建vue前端和. ...
  • Csharper中的表達式樹 這節課來瞭解一下表示式樹是什麼? 在C#中,表達式樹是一種數據結構,它可以表示一些代碼塊,如Lambda表達式或查詢表達式。表達式樹使你能夠查看和操作數據,就像你可以查看和操作代碼一樣。它們通常用於創建動態查詢和解析表達式。 一、認識表達式樹 為什麼要這樣說?它和委托有 ...
  • 在使用Django等框架來操作MySQL時,實際上底層還是通過Python來操作的,首先需要安裝一個驅動程式,在Python3中,驅動程式有多種選擇,比如有pymysql以及mysqlclient等。使用pip命令安裝mysqlclient失敗應如何解決? 安裝的python版本說明 機器同時安裝了 ...