阿里云API網(wǎng)關(guān)服務(wù)-使用手冊(cè)-D

《阿里云API網(wǎng)關(guān)服務(wù)-使用手冊(cè)-D》由會(huì)員上傳分享，免費(fèi)在線閱讀，更多相關(guān)內(nèi)容在行業(yè)資料-天天文庫。

1、API網(wǎng)關(guān)使用手冊(cè)（開放API）API網(wǎng)關(guān)/使用手冊(cè)（開放API）使用手冊(cè)（開放API）提供APIAPI網(wǎng)關(guān)（APIGateway），提供高性能、高可用的API托管服務(wù)，幫助您對(duì)外開放您部署在ECS、容器服務(wù)等阿里云產(chǎn)品上的應(yīng)用，為您提供完整的API發(fā)布、管理、維護(hù)生命周期管理。您只需簡(jiǎn)單操作，即可快速、低成本、低風(fēng)險(xiǎn)的開放數(shù)據(jù)或服務(wù)。在API網(wǎng)關(guān)您可以：1.管理您的API您可以對(duì)API的整個(gè)生命周期進(jìn)行管理，包括API的創(chuàng)建、測(cè)試、發(fā)布、下線、版本切換等操作。2.便捷轉(zhuǎn)換數(shù)據(jù)支持自定義映射規(guī)則，您可以配置映射將調(diào)用請(qǐng)求轉(zhuǎn)換成后端需要的格式。3.預(yù)設(shè)請(qǐng)求校驗(yàn)?zāi)梢灶A(yù)

2、先設(shè)置參數(shù)類型、參數(shù)值（范圍、枚舉、正則、JsonSchema）校驗(yàn)，由網(wǎng)關(guān)幫助您過濾掉非法請(qǐng)求，減少您的后端對(duì)非法請(qǐng)求的處理成本。4.靈活控制流量您可以對(duì)API、用戶、應(yīng)用設(shè)置按分鐘、小時(shí)、天的調(diào)用量控制。您還可以設(shè)置特例用戶或者應(yīng)用，對(duì)某個(gè)用戶或應(yīng)用單獨(dú)配置流量控制。輕松安全防護(hù)支持Appkey認(rèn)證，HMAC（SHA-1,SHA-256）算法簽名。支持SSL/TSL加密，并借助阿里云盾防病毒、防攻擊。全面監(jiān)控與報(bào)警為您提供可視化API實(shí)時(shí)監(jiān)控，包括：調(diào)用量、調(diào)用方式、響應(yīng)時(shí)間、錯(cuò)誤率，并支持歷史情況查詢，以便統(tǒng)籌分析。您還可以配置預(yù)警方式（短信、Email）,訂

3、閱預(yù)警信息，以便實(shí)時(shí)掌握API運(yùn)行情況。7.降低開放成本為您自動(dòng)生成API文檔和SDK（服務(wù)端、移動(dòng)端），降低API開放成本。創(chuàng)建API創(chuàng)建API是定義API請(qǐng)求的過程。您需要在創(chuàng)建中定義API的請(qǐng)求調(diào)用格式、定義網(wǎng)關(guān)拋向后端服務(wù)的請(qǐng)求格式、定義返回結(jié)果格式、定義參數(shù)校驗(yàn)規(guī)則等等。定義請(qǐng)求的基本信息API基本信息包括API分組、API名稱、描述、API類型。9API網(wǎng)關(guān)/使用手冊(cè)（開放API）1.API創(chuàng)建時(shí)需要選擇分組。分組是API的管理單元，創(chuàng)建API之前您需要先創(chuàng)建分組。（API分組的詳細(xì)說明見下文的"分組及域名"）分組攜帶Region屬性且每個(gè)分組有不同的域

4、名，同一個(gè)分組下的API的Region和域名都是相同的。分組一旦選定不可更改。2.API名稱應(yīng)為該分組下唯一，一旦選定不可更改。3.API類型分為公開和私有兩種。在公測(cè)階段，兩種類型無實(shí)際差別。定義請(qǐng)求的后端服務(wù)信息API后端服務(wù)信息包括后端服務(wù)類型、后端服務(wù)地址和后端超時(shí)時(shí)間。1.后端服務(wù)類型。目前僅支持HTTP，其他類型如Sigma、Mock后續(xù)會(huì)陸續(xù)支撐。2.后端服務(wù)地址。是指API網(wǎng)關(guān)調(diào)用底層服務(wù)時(shí)的完整地址，包含域名/IP+Path?？梢园瑒?dòng)態(tài)參數(shù)，比如動(dòng)態(tài)參數(shù)為username，寫作[username]，這些動(dòng)態(tài)參數(shù)只能從調(diào)用者傳入的Path中獲取，所

5、以您需要在下一步配置Path時(shí)選擇性的做映射，并且定義最終Path時(shí)不要遺漏這些動(dòng)態(tài)參數(shù)。后端服務(wù)地址中不能包含Query參數(shù)。3.后端超時(shí)時(shí)間。指API請(qǐng)求到達(dá)網(wǎng)關(guān)后，由網(wǎng)關(guān)去調(diào)API后端服務(wù)的響應(yīng)時(shí)間，由網(wǎng)關(guān)請(qǐng)求后端開始到網(wǎng)關(guān)收到后端返回結(jié)果的時(shí)間。該值不能超過30秒。定義API請(qǐng)求格式API請(qǐng)求格式定義包括協(xié)議及方法定義、Path的定義、入?yún)⒍x、系統(tǒng)參數(shù)定義、參數(shù)映射、參數(shù)校驗(yàn)定義。1.協(xié)議及方法定義。API調(diào)用支持HTTP/HTTPS協(xié)議。Method方法可選擇PUT、GET、POST、DELETE、HEAD、MULITIPART。2.Path定義。這個(gè)P

6、ath是指服務(wù)對(duì)外開放后，調(diào)用者調(diào)用API網(wǎng)關(guān)時(shí)的路徑，可以與后端服務(wù)地址中的Path不同，網(wǎng)關(guān)會(huì)保存對(duì)應(yīng)關(guān)系完成尋址。如果您輸入的后端服務(wù)地址中存在動(dòng)態(tài)參數(shù)，這些動(dòng)態(tài)參數(shù)需要通過Path獲取，您可以在定義Path的時(shí)候進(jìn)行參數(shù)映射，注意最終的Path地址不要遺漏這些動(dòng)態(tài)參數(shù)。只要保證該P(yáng)ath中的動(dòng)態(tài)參數(shù)與后端服務(wù)地址中的動(dòng)態(tài)參數(shù)相對(duì)應(yīng)即可，其他部分可以與后端服務(wù)地址中的Path不同。3.入?yún)⒍x。您在這部分定義用戶調(diào)用API時(shí)需要傳入的參數(shù)，分別對(duì)請(qǐng)求的Header、Query和Body進(jìn)行入?yún)⒍x。您需要定義用戶請(qǐng)求傳入的參數(shù)名稱，參數(shù)類型如String、Nu

7、mber、Boolean、Json等。選擇參數(shù)是否必填，并給出示例值、默認(rèn)值及描述。Body參數(shù)可以選擇透?jìng)鳌?.參數(shù)校驗(yàn)定義。在定義入?yún)r(shí)，您還可以點(diǎn)擊"更多"來為該參數(shù)設(shè)置校驗(yàn)，如枚舉值、String的長(zhǎng)度校驗(yàn)、Number的最大最小值校驗(yàn)等等。網(wǎng)關(guān)會(huì)預(yù)先對(duì)非法請(qǐng)求進(jìn)行攔截，減輕您后端服務(wù)的負(fù)擔(dān)。5.參數(shù)映射。如果您想要用戶輸入的參數(shù)名稱與您后端實(shí)際的參數(shù)名稱不符，或者您后端實(shí)際參數(shù)名稱不方便直接暴露給用戶，那么您只需要在定義參數(shù)時(shí)選擇需要參數(shù)映射，既可以為每個(gè)參數(shù)配置起后端參數(shù)映射。系統(tǒng)參數(shù)定義。系統(tǒng)參數(shù)對(duì)于API的調(diào)用者是不可見的。系統(tǒng)參數(shù)有兩種，一種是