原生 git 的 API Reposiotry

API 已成為現代軟件和業務基礎架構不可或缺的一部分，提供了一種擴展軟件功能並實現與外部服務高效集成的方法。因此，越來越多的各行各業的組織都在投資 API 開發，以增強內部和外部工作流程。

API 開發過程涉及多個階段和利益相關者，使用不同的工具和流程。了解 API 生產者和消費者生命週期的各個階段對於 API 的成功開發和管理至關重要。這些階段通常包括規劃、設計、開發、測試、部署和維護 API。

API 生產者負責創建和管理 API，而 API 消費者則利用 API 構建應用程序或與現有軟件集成。這兩個生命週期在不同階段交叉，例如在測試階段，API 生產者確保 API 滿足 API 消費者的要求。

Apigit API 平台旨在幫助組織更有效地完成 API 開發和管理流程。使用 Apigit，原生 Git 支持是一項關鍵功能，允許用戶將他們的 API 作為代碼進行管理，並與其他團隊成員無縫協作。

通過利用 Apigit 的功能，組織可以簡化他們的 API 開發和管理流程，減少構建和部署高質量 API 所需的時間和精力。這最終會提高運營效率並更好地與外部服務集成，使企業能夠在現代數字環境中保持競爭力。

什麼是 API 存儲庫？

Apigit的API Repository，是navtive Git Repository，是你創建API和管理API整個生命週期的地方。 API 存儲庫保存和維護 API 文檔、測試和規範以及代碼。這允許 Apigit 客戶改善與 API 生產者的協作，因為您可以在多用戶、多分支設置中與您的團隊合作。在您準備好發布之前，您可以在不影響您的團隊或消費者的情況下提交和推送更改。

API開發生命週期

如何使用 API 存儲庫來管理您的 API

第 1 步：創建存儲庫

Apigit 的 API 抽像是所有 API 工作流的核心。首先，創建一個存儲庫並添加 API 規範。

隨著越來越多的開發團隊構建 API 而不是共享庫，源代碼協作通常與其他 API 工作流程（Apigit 集合、定義、合同測試和文檔）脫節。這會導致次優的生產力； API 在整個組織中重複，合同並不總是得到遵守。我們相信存儲庫是更廣泛的 API 構造的一個組成部分，因為它包含 API 的源代碼。

第 2 步：設計、開發並與您的隊友協作

現在 API Repository 已經設置好了，您可以開始設計和開發它了。在 Apigit 中添加定義和集合，模擬和測試 API。

對於 Git 鏈接的 API，您總是在一個分支上工作。當前分支顯示在 API 上（檢查右上角），源代碼管理面板在右側。您可以像在本機 git 中一樣提交和推送更改到您的存儲庫。在任何時候，您還可以查看提交歷史，將您的更改與上次提交進行比較，甚至放棄更改。所有這一切現在都可以在 Apigit 中實現，使您能夠根據您的團隊採用的 Git 工作流程有效地工作。

API 開發的一個重要部分是與您的隊友協作。您的隊友現在可以提取您所做的更改並開始協作。如果同時對同一文件進行更改，Apigit 允許您解決衝突。

所做的更改僅對 API 的編輯者可見——他們可以切換到分支並查看對存儲庫所做的所有更改。

第 3 步：測試和自動化 API

您可以從向 API 存儲庫添加測試開始。這些可以通過模擬複雜的 API 使用場景來驗證您的 API 的功能。

API 開發完成後，即可將其部署到您的運行時環境中。

第 4 步：發布您的 API 並將其分發給消費者

作為一個跨多個分支處理複雜 API 的團隊，您的利益相關者（無論是團隊內部還是外部）都需要一個可參考的 API、完整的文檔和一個沙箱以啟用評估端點。

您現在可以擁有 API 的版本，就像 API 的鎖定狀態一樣，您可以將其發送給消費者。版本發布後，消費者將繼續看到該版本，直到您發布新版本。消費者還可以返回到之前發布的任何版本。這有助於您將任何開發中的更改與您的 API 使用者隔離開來，並且他們只會看到您希望他們使用的 API 的穩定/已發布版本。

版本還可以幫助您隨時間記錄 API 的變更日誌，這可用於指示您的 API 在多個版本中的發展情況。

第 5 步：收集反饋並迭代您的 API

API 發布後，您將獲得一些反饋，並可能希望開始添加新的端點或修復一些問題。您可能會從您的集合中發送一些請求，以了解當前的 API 行為並編輯您的 API 定義或集合。

您的下一步將是進行更新並將更改推送到您的存儲庫。您可以首先在 Apigit 中創建一個新分支並對 API 進行更改。

在任何時候，您都可以放棄您在 Apigit 存儲庫中所做的更改，或者查看您所做的更改與存儲庫的最後狀態之間的差異，最後將更改推送到存儲庫。