摘要: 為了向開發者提供良好、一致、穩定的華為API的體驗,華為通過明確“API管理六項原則”,來支援開發者生態建設。
一個不開放的組織,會慢慢成為一潭僵水,一個封閉的系統,能量最終會耗盡,在產品開發上,同樣需要開放,需緊緊圍繞業務架構,在業務層面走向開放,並不是什麼都去做,而是能啟用別人來做。在行業數字化轉型中,不少領頭羊的企業在構築聯接、雲、大資料、人工智慧等方面的競爭力的同時,也在利用技術、資料、資本等各種手段吸引和獲取垂直行業的優質生態資源,通過能力開放,吸引更多的開發者參與生態建設。
平臺在企業內部走向開放的同時,也需要進一步向生態開放,支援企業的生態佈局。即產品和平臺通過開放的應用程式設計介面(Application Programming Interface,API)的方式對外開放能力,生態中的開發者利用該API,將其上層應用與開放的能力融合,構建差異化的創新解決方案,助力企業客戶數字化轉型和商業成功。
為了向開發者提供良好、一致、穩定的華為API的體驗,華為通過明確“API管理六項原則”,來支援開發者生態建設。
1、 價值原則:制定明確的可衡量的API價值指標,牽引價值提升。
2、 穩定性原則:通過API版本管理,避免和減少對開發者的影響,保證API穩定性。
3、 易用性原則:API設計要面向開發者,提供從學習、開發到應用釋出全過程的良好體驗。
4、 安全性原則:制定API相關的風險控制措施以保護資料和監控訪問。
5、 一致性原則:API應按統一的格式規範、釋出渠道對外呈現,以保持一致的開發者體驗。
6、 服務支援原則:遵循統一的流程規範,為開發者提供良好的服務支援。
華為通過在產品和平臺落地“API管理六項原則”,為生態中的開發者應用API時提供良好的體驗,有效支援了開發者生態建設、企業客戶數字化轉型和公司雲化戰略落地。——節選自《從偶然到必然:華為研發投資與管理實踐》
面向開發者,華為雲提供了完整的系列工具集和服務,支援API全生命週期的管理:
華為雲自身的服務,以及合作伙伴的服務,通過API閘道器對外提供;
API閘道器負責API的管理、分發、流控、快取、監控以及SDK和CLI的生成;
對外提供的API,可以在API Explorer進行查詢和除錯,也可以進行API編排,同時也可以在雲市場API專區進行直接交易;
與此同時,華為雲提供全系列的工具,支援API的設計、開發、測試以及釋出的全流程管理。
從華為雲官網開發者資源工具下的API Explorer,可以獲取華為雲開放的2800+的API資訊。這裡匯聚了華為雲服務所有開放的API,大家可以在這個平臺上快速的檢視和搜尋、檢視API文件、隨時搜尋API錯誤碼,我們同時提供了線上視覺化除錯的功能,方便學習和掌握API的使用。
API Explorer的關鍵能力,首先是支援開放API的線上檢索和視覺化除錯,可以定位到雲服務,快速查詢雲服務下所有開放API;選擇API後,通過填寫引數,可以直接進行線上除錯,可以直接檢視API的呼叫返回結果。
通過API文件可以獲取更詳盡的資訊,包括介面約束、請求引數說明、示例、返回引數以及SDK等非常全的資訊。我們呼叫介面返回的錯誤碼,可以通過錯誤碼中心,快速找到對應的錯誤詳細資訊以及處理措施建議,快速解決API呼叫出現的問題。
另一個關鍵能力是程式碼示例,支援Java、Python、Go、C#等主流語言呼叫SDK來訪問華為雲開放API;同時支援CLI呼叫API,在安裝部署、變更升級、擴容等場景下,可以使用命令列、批處理的方式來操作。華為雲提供了不同OS(Windows、Linux、MacOS等)下的CLI工具,支援依據使用者填寫的引數來快速生成CLI命令,來操作華為雲的開放API。
想要獲取更多關於華為雲API資訊?
“免費下載創新加速利器《華為雲API精選手冊》。
華為雲API精選手冊(第一期刊).pdf 4.18MB
—— 活動推薦 ——
華為雲已經成為全球主要雲服務供應商,在華為雲上開放了2400+ API,包括計算、儲存、網路、應用服務、軟體開發服務、視訊、資料庫、EI智慧等74+產品,如何利用這些豐富強大的API快速開發自己的應用和服務,成為大家關注的熱點。
華為雲API學習賽,為入門初學者量身定製的學習平臺,以賽帶學,學以致用。無需程式碼,只需下載體驗模板,按操作文件操作即可完成作品。參賽、邀請都有豐富獎品,還有機會拿P40 5G手機超級激勵!!識別下圖二維碼即可報名參加。
API入門學習賽·AI人臉識別
API入門學習賽·探險尋寶之旅