【API設計】 引言：應該使用ORM框架嗎？ 毋庸置疑，Sticker微服務需要訪問數據庫來管理“貼紙”（也就是“Sticker”），因此，以什么方式來存儲數據，就是一個無法繞開的話題。如果你遵循領域驅動設計的思想，那么你可以說，保存到數據庫的數據，...

【API設計】 涉及知識點 Gin：Golang 的一個微框架，性能極佳。 beego-validation：本節采用的 beego 的表單驗證庫，中文文檔。 gorm，對開發人員友好的 ORM 框架，英文文檔 com，一個小而美...

【API設計】 思考 首先，在一個初始項目開始前，大家都要思考一下 程序的文本配置寫在代碼中，好嗎？ API 的錯誤碼硬編碼在程序中，合適嗎？ db 句柄誰都去Open，沒有統一管理，好嗎？ 獲取分頁等公共參數，誰都自己寫一...

【API設計】 一、 背景 gin框架作為一個普遍使用的http服務開源框架，為了能更好地使用它，我們有必要對gin框架有個清晰的認識，了解框架中請求處理流程、中間件執行等細節。gin框架基于golang基礎庫 net/http 進行開發，先了解 n...

【API設計】 方案設計 開始開發之前我們先看一下 gin 的路由是怎么注冊的，以及 grpc 生成的接口格式是什么樣的 gin example package main?import "github.com/gin-gonic/gin"...

【API設計】 序 在 Go 工程化(二) 項目目錄結構 中我們大概講了一下 api 目錄，但是并沒有詳細的說明，留在這這篇文章一起講。 API 設計將分為四個部分: 首先會講一下 API 的項目目錄結構，在項目中 api 該如何組織，...

【API設計】 WebSocket 示例界面 第三方包 gorilla/websocket[1] websocket?鏈接時支持配置項： type Upgrader struct { // 指定升級 webso...

【API設計】 gin 是golang 中比較流行的框架，很多系統都是在該框架下開發的，這個框架給我的感覺像是Flask在python中的位置，基礎的功能都有，但是如果想要很好的使用，還需要開發很多自己的功能與中間件，在看過不少的教程以后，想要記錄一下學習...

【API設計】 數據安全一直是個熱門的話題，API 接口在數據的傳輸上扮演著至關重要的角色。為了 API 接口的安全性、健壯性，完整性，往往需要將網絡上的數據進行簽名加密傳輸。同時為了防止 API 接口被重放爬蟲偽造等類似惡意攻擊的手段，還要在接口設計時增加有效時間、隨機字符串、簽名串等參數，來保障數據的安全性。這一次的 API 接口簽名設計實踐，大家也可以手動嘗試實驗一下，希望對大家的日常工作能有所幫助。

【API設計】 API 優先方法強調在軟件開發生命周期伊始就將 API 設計與創建置于核心地位，將其視為決定其他應用程序代碼開發的基礎組件，從而確保服務之間的一致性與可重用性，為應用程序帶來可擴展性、靈活性以及與微服務架構的無縫集成等顯著優勢。有效的 API 優先策略實施涵蓋全面的文檔、標準化的錯誤處理和強大的 API 治理，這不僅培養了更佳的開發人員體驗、激發創新活力，還使得 API 能夠在組織內跨不同語言和平臺實現無縫交互，支持無依賴項的升級與更新，極大地增強了系統的健壯性與靈活性。盡管在采用 API 優先實踐過程中可能存在諸如文化轉變、技術多樣性管理等挑戰，但其帶來的顯著架構優勢不容小覷，能夠加快產品上市時間、實現經濟高效的應用程序開發，推動組織在激烈的市場競爭中保持領先，引領軟件開發邁向更具前瞻性與戰略性的新階段。

【API設計】 API網關是隨著微服務概念興起的一種架構模式。原本一個龐大的單體應用（All in one）業務系統被拆分成許多微服務系統進行獨立的維護和部署，服務拆分帶來的變化是API的規模成倍增長，API的管理難度也在日益增加，使用API網關發布和管理API逐漸成為一種趨勢。一般來說，API網關是運行于外部請求與內部服務之間的一個流量入口，實現對外部請求的協議轉換、鑒權、流控、參數校驗、監控等通用功能。

【API產品】 2022 年是科技圈艱難的一年，很少有振奮人心的消息。驚喜的是年底 OpenAI 開放的 ChatGPT，一下點燃了整個科技圈，體驗后感覺有點像人腦，智能化程度驚艷。曾經我和朋友常調侃人工智能就是“有多少人工，就有多少智能”，ChatGPT...

【API設計】 本文探討了微軟開源的Autogen框架，該框架基于大型語言模型（LLM）構建自治代理（autonomous agents），支持多個代理的協作以實現共同目標。Autogen允許代理進行單聊和群聊，并提供多種發言人選擇方法。盡管該框架在實現多個代理的協作方面具有優勢，但在將其集成到實際生產環境中（如Web APP）時仍面臨一些挑戰，如缺乏成熟的文檔和資源。 文章詳細介紹了如何使用Autogen構建一個基于API的旅游代理系統，包含多個角色的代理，例如旅游代理、位置研究員和用戶代理。系統通過與SERP API的交互，允許代理收集和處理用戶的旅行需求。最后，文章討論了在群聊中提高代理協作可預測性和一致性的可能方法，包括修改發言人選擇邏輯和使用圖模型來強制執行發言者轉移路徑。 總體而言，文章展示了Autogen在多代理系統中的應用潛力及其在實際應用中面臨的挑戰與解決方案。

【API設計】 文章總結了API設計中應遵循的重要原則。首先強調了簽名的重要性，通過將請求參數、時間戳和密鑰拼接后進行hash算法處理生成簽名，以防止數據被篡改，并通過時間戳限制請求的有效期。在數據安全方面，建議對敏感數據進行加密，如使用AES對稱加密算法保護用戶密碼等重要信息。此外，文章還提出了其他設計要點，包括設置IP白名單以限制訪問來源、實施限流策略以避免服務過載、進行嚴格的參數校驗以攔截無效請求、統一返回值和異常處理以簡化維護工作、記錄詳細的請求日志以便快速定位問題、設計冪等接口以避免重復操作、限制批量接口的記錄條數以防止超時、進行壓力測試以評估接口性能、采用異步處理以提升性能、對敏感數據進行脫敏處理以保護隱私、提供完整的接口文檔以降低對接成本、合理選擇請求方式、利用請求頭傳遞公共參數、設計批量接口以提高通用性以及遵循職責單一原則以降低維護難度。這些軍規旨在幫助開發者設計出更安全、高效、易維護的API接口。

【API設計】 本文深入探討了提升系統性能和優化技術的關鍵策略，包括并行處理、最小化事務范圍、緩存應用、合理使用線程池、服務預熱、緩存對齊、減少對象產生、并發處理、異步處理以及循環優化等十二個方面。文章強調了在高并發場景下，通過減少事務范圍和合理使用緩存來提升系統響應速度和可靠性。同時，討論了線程池的配置和監控、服務預熱、緩存對齊以及減少對象產生的重要性，這些措施有助于降低系統延遲和提高吞吐量。