檢測(cè)到您已登錄華為云國際站賬號(hào),為了您更好的體驗(yàn),建議您訪問國際站服務(wù)網(wǎng)站 http://m.cqfng.cn/intl/zh-cn
不再顯示此消息
微服務(wù)API接口設(shè)計(jì)規(guī)范
目錄 文章目錄 目錄 API 實(shí)現(xiàn)方式 Design-First(設(shè)計(jì)優(yōu)先) Code-First(編碼優(yōu)先) API 設(shè)計(jì)規(guī)范 為用戶設(shè)計(jì) API 識(shí)別 API 的目標(biāo) Mock API Server
微服務(wù)API接口設(shè)計(jì)規(guī)范 API設(shè)計(jì)原則 API設(shè)計(jì)規(guī)范 父主題: 微服務(wù)架構(gòu)設(shè)計(jì)
前言 RESTful API 設(shè)計(jì)規(guī)范是確保接口一致性、可維護(hù)性和易用性的關(guān)鍵。
特性二:規(guī)范設(shè)計(jì),品質(zhì)保障,API設(shè)計(jì)規(guī)范性檢查 Swagger編輯模式下,支持API設(shè)計(jì)規(guī)范檢查;可設(shè)置無需檢查接口,靈活控制每個(gè)接口的規(guī)范檢查,保證API設(shè)計(jì)質(zhì)量。
API概覽 CSS提供的接口為符合RESTful API設(shè)計(jì)規(guī)范的自研接口。通過CSS的自研接口,您可以使用CSS的如表2所示的功能。 本服務(wù)已上線部分V2版本的API,請(qǐng)優(yōu)先使用V2版本的API。
編輯模式與API規(guī)范檢查 CodeArts API在API設(shè)計(jì)界面提供代碼編輯模式進(jìn)行API設(shè)計(jì),可使用yaml格式設(shè)計(jì)接口文檔。在編輯模式中CodeArts API提供API規(guī)范性檢查。 通過規(guī)范性檢查功能,可以形成統(tǒng)一的設(shè)計(jì)規(guī)范,避免API設(shè)計(jì)不一致,提高API設(shè)計(jì)質(zhì)量。
編輯模式與API規(guī)范檢查 CodeArts API在API設(shè)計(jì)界面提供代碼編輯模式進(jìn)行API設(shè)計(jì),可使用yaml格式設(shè)計(jì)接口文檔。在編輯模式中CodeArts API提供API規(guī)范性檢查。 通過規(guī)范性檢查功能,可以形成統(tǒng)一的設(shè)計(jì)規(guī)范,避免API設(shè)計(jì)不一致,提高API設(shè)計(jì)質(zhì)量。
文檔路徑缺省為http://app-url/resources/microservices/{服務(wù)名}.yaml 父主題: API設(shè)計(jì)規(guī)范
API概覽 CAE API為符合API設(shè)計(jì)規(guī)范的自研接口。 環(huán)境接口 表1 環(huán)境接口介紹 API 說明 獲取環(huán)境列表 此API用來獲取當(dāng)前項(xiàng)目下的環(huán)境列表。 創(chuàng)建環(huán)境 此API用來創(chuàng)建環(huán)境。 刪除環(huán)境 此API用來刪除對(duì)應(yīng)的環(huán)境。
API概覽 醫(yī)療智能體平臺(tái)所提供的API,均符合RESTful API設(shè)計(jì)規(guī)范,如表1所示。 臨床研究和藥物設(shè)計(jì)所提供的API,均符合RESTful API設(shè)計(jì)規(guī)范,如表2所示。
API概覽 DIS提供的接口為符合RESTful API設(shè)計(jì)規(guī)范的自研接口。 通過DIS的自研接口,您可以使用DIS的如API說明所示的功能。
API概覽 Koosearch提供的接口為符合RESTful API設(shè)計(jì)規(guī)范的自研接口。通過Koosearch的自研接口,您可以使用Koosearch的表1 接口說明所示的功能。 表1 接口說明 類型 說明 知識(shí)庫管理接口 知識(shí)庫管理等相關(guān)接口。
DLV所提供的接口均為符合RESTful API設(shè)計(jì)規(guī)范的自研接口。通過DLV的自研接口,您可以使用如表1所示的DLV功能。
API概覽 人臉識(shí)別服務(wù)所提供的API,均符合RESTful API設(shè)計(jì)規(guī)范,如表1所示。 表1 人臉識(shí)別API 類型 API 說明 人臉檢測(cè) 人臉檢測(cè) 人臉檢測(cè)是對(duì)輸入圖片進(jìn)行人臉檢測(cè)和分析,輸出人臉在圖像中的位置、人臉關(guān)鍵屬性。
API概覽 TICS提供的接口為符合RESTful API設(shè)計(jì)規(guī)范的自研接口。 使用空間API可以查詢TICS空間的相關(guān)信息,如獲取空間列表、獲取計(jì)算節(jié)點(diǎn)列表等。
API概覽 AI科學(xué)計(jì)算服務(wù)所提供的API,均符合RESTful API設(shè)計(jì)規(guī)范,如表1所示。 表1 AI科學(xué)計(jì)算服務(wù)API 類型 API 說明 空間管理 空間管理 空間創(chuàng)建、獲取空間詳情、刪除空間等相關(guān)操作API。
HTTP/1.1 303 See other Content-Type: application/json Location: https://example.com/photos/4577 父主題: API設(shè)計(jì)規(guī)范
設(shè)計(jì)規(guī)范
None 產(chǎn)品介紹 CodeArts API 帶您了解CodeArts API 02:34 介紹CodeArts API 操作指導(dǎo) CodeArts API 介紹如何創(chuàng)建API設(shè)計(jì)及兩種設(shè)計(jì)編輯模式 03:20 創(chuàng)建API設(shè)計(jì) CodeArts API 介紹如何設(shè)置API設(shè)計(jì)規(guī)范