資源描述:
《阿里云API網(wǎng)關(guān)服務-API手冊-D》由會員上傳分享,免費在線閱讀,更多相關(guān)內(nèi)容在行業(yè)資料-天天文庫。
1、API網(wǎng)關(guān)使用手冊(調(diào)用API)API網(wǎng)關(guān)/使用手冊(調(diào)用API)使用手冊(調(diào)用API)調(diào)用API您可以通過API網(wǎng)關(guān),調(diào)用由其他阿里云用戶或者第三方服務商開放的API服務。API網(wǎng)關(guān)將為您提供一系列管理服務與支撐。調(diào)用示例您可以基于API網(wǎng)關(guān)提供的SDK,通過編寫代碼的方式調(diào)用API。也可以自行編輯HTTP請求調(diào)用API。API的請求結(jié)構(gòu)如下://假如,域名:a13db7999e494a90819cce500130034d.com//假如,Path:/web/cloudapi/mapping/service//假如,Query內(nèi)容是:a=n
2、ame,b=12http://a13db7999e494a90819cce500130034d.com/web/cloudapi/mapping/service?a=name&b=12//則請求的url如下//請求的MethodPOSTHttpMethod:POST//Headers中需要包含簽名信息和部分參數(shù)X-Ca-Version:1//API版本X-Ca-Signature-Headers:X-Ca-Version,X-Ca-Key,X-Ca-Stage,X-Ca-Timestamp//參與簽名的HeaderX-Ca-Key:60028
3、305//AppKeyX-Ca-Stage:test//StageX-Ca-Timestamp:1456905123049//時間戳X-Ca-Signature:UAaH/qteir4G9UK4YR+NWdyq+c1rjl0PvtO/C1Qo68U=//簽名//詳細加密簽名的計算傳遞方式,請查看文檔--入口及協(xié)議。//Http標準頭//服務地址Host:a13db7999e494a90819cce500130034d.comDate:Wed02Mar201607:52:02GMT5API網(wǎng)關(guān)/使用手冊(調(diào)用API)User-Agent:Apa
4、che-HttpClient/4.1.2(java1.6)Content-Type:application/x-www-form-urlencoded;charset=utf-8Amount=11&InstanceId=ClientInstanceId&InstanceName=ClientInstanceName//Body內(nèi)容以上內(nèi)容加上API的入?yún)⒕蜆?gòu)成了API請求。其中,在公測階段,您需要在線下從提供API的服務方獲取API的說明文檔,獲取服務地址、Path等詳細說明。AppKey是您創(chuàng)建的APP的密鑰,用于做身份驗證。APP是您調(diào)用
5、API需要創(chuàng)建的身份。詳情將在后續(xù)內(nèi)容中說明。應用(APP)您需要創(chuàng)建應用(APP)作為您調(diào)用API的身份,每個APP有一對AppKey和AppSecret密鑰對,用于您請求時做加密簽名,網(wǎng)關(guān)會對簽名做驗證。1.在API網(wǎng)關(guān),您需要創(chuàng)建應用(APP)作為請求者的身份。APP創(chuàng)建時,系統(tǒng)會自動分配一對AppKey和AppSecret,AppKey用于標識您的身份,AppSecret是用于加密簽名字符串和服務器端驗證簽名字符串的密鑰。調(diào)用API時您需要將AppKey和AppSecret加密簽名放入請求參數(shù),API網(wǎng)關(guān)會通過對稱加密來驗證您的身份。
6、詳細加密簽名的計算傳遞方式,請查看文檔--入口及協(xié)議。2.AppKey和AppSecret密鑰對,具備該APP的全部權(quán)限,需要妥善保管。如果發(fā)生泄漏,您可以在API網(wǎng)關(guān)的控制臺進行重置。3.您可以擁有多個APP,可以根據(jù)您的業(yè)務需求分別被授權(quán)不同的API。注意,API的授權(quán)對象是APP而不是阿里云用戶賬號。4.您可以在API網(wǎng)關(guān)控制臺完成對APP的創(chuàng)建、修改、刪除、查看詳情、密鑰管理、查看已授權(quán)等管理操作。授權(quán)授權(quán),是指授予APP調(diào)用某個API的權(quán)限。您的APP需要獲得API的授權(quán)才能調(diào)用該API。在公測階段,由API服務方建立APP和API
7、之間的權(quán)限關(guān)系。1.在公測階段,由提供API的服務方來建立授權(quán)關(guān)系,您需要向其提供AppID或者您的阿里云郵箱賬戶,說明給予某一個APP進行授權(quán)。授權(quán)建立后,您就可以使用該APP調(diào)用API了。2.在公測階段,您不具備建立或者刪除授權(quán)的權(quán)限。您僅可以在控制臺查看相應APP下已經(jīng)被授權(quán)的API。如果您需要解除某個API的授權(quán),請您聯(lián)系A(chǔ)PI服務提供方。加密簽名您調(diào)用API時,需要使用AppKey和AppSecret計算加密簽名,完成身份驗證。5API網(wǎng)關(guān)/使用手冊(調(diào)用API)1.在API網(wǎng)關(guān),使用APP作為您調(diào)用API的身份。APP創(chuàng)建時,系統(tǒng)
8、會自動分配AppKey和AppSecret。服務器端會通過驗證AppKey和AppSecret來完成請求者的身份驗證。2.無論使用HTTP還是HTTPS協(xié)議提交請求