本文在介紹接口調用之后如何處理返回結果的基礎上,重點探討了其具體步驟,本文內容很緊湊,希望大家耐心學習。
返回結果
返回結果主要有 xml 和 json 兩種格式,默認為 XML,您可以指定公共請求參數 format 變更返回結果的格式。更多詳情,請參閱 公共參數。為了便于查看和美觀,API 文檔返回示例均有換行和縮進等處理,實際返回結果無換行和縮進處理。
正常返回示例
接口調用成功后會返回接口返回參數和請求 ID,我們稱這樣的返回為正常返回。http 狀態碼為 2xx。
XML 示例
<?xml version="1.0" encoding="UTF-8"?>?<!--結果的根結點--> <actionresponse>?<!--返回請求標簽--> ????<requestid>4C467B38-3910-447D-87BC-AC049166F216</requestid>?<!--返回結果數據--> </actionresponse>
JSON 示例
{ ????"RequestId":?"4C467B38-3910-447D-87BC-AC049166F216"?/*?返回結果數據?*/ }
異常返回示例
接口調用出錯后,會返回錯誤碼、錯誤信息和請求 ID,我們稱這樣的返回為異常返回。HTTP 狀態碼為 4xx 或者 5xx。
您可以根據接口錯誤碼以及 公共錯誤碼 以及 API 錯誤中心 排查錯誤。當您無法排查錯誤時,可以 提交工單 聯系我們,并在工單中注明服務節點 HostId 和 RequestId。
XML 示例
<?xml version="1.0" encoding="UTF-8"?><!--結果的根結點--><error> ????<requestid>540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx</requestid>?<!--請求 ID--> ????<hostid>ecs.aliyuncs.com</hostid>?<!--服務節點--> ????<code>MissingParameter.CommandId</code>?<!--錯誤碼--> ????<message>The?input?parameter?“CommandId”?that?is?mandatory?for?processing?this?request?is?not?supplied.</message>?<!--錯誤信息--> </error>
JSON 示例
{ ????"RequestId":?"540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx",?/*?請求?ID?*/ ????"HostId":?"ecs.aliyuncs.com",?/*?服務節點?*/ ????"Code":?"MissingParameter.CommandId",?/*?錯誤碼?*/ ????"Message":?"The?input?parameter?“CommandId”?that?is?mandatory?for?processing?this?request?is?not?supplied."?/*?錯誤信息?*/ }
公共錯誤碼
? 版權聲明
文章版權歸作者所有,未經允許請勿轉載。
THE END