【“網際網路+”大賽華為雲賽道】API命題攻略：釐清三步解題思路，用好開發工具
摘要：結合華為雲API開放平臺API Exploer實現照片分類系統。
API能為我們帶來什麼？
有了 API，可以建立管理雲伺服器、雲容器、雲硬碟，提高工作效率；可以接入影象識別、情感分析、內容稽核等能力，不懂 AI 照樣玩轉各種 AI 技能；還可以快速實現視訊點播、對話機器人等成熟應用能力……
但是國內的API生態尚處在初期發展階段，許多優秀的API還是滄海遺珠，很多企業在創新中也常因為不瞭解有現成可用的API而進行重複開發。
API經濟時代下，為了讓大家更好的瞭解API以及它的應用，本次“網際網路+”大賽從實際問題出發，推出了相關賽題——結合華為雲API開放平臺API Exploer實現照片分類系統。
本文從賽題介紹、說明和要求說起，梳理解題步驟和關鍵思路，以及相關開發工具的使用指南和樣例。希望這份賽題解答攻略，可以幫助廣大參賽選手取得佳績。
賽題介紹：用API解決現實問題
一個典型的中國家庭包括4位老人、2位成年人和1位孩子（4+2+1），並且人手一部手機，他們在日常生活以及工作學習中會用手機拍攝大量照片，這些照片基本儲存在各自的手機中，然後通過微信、微博、抖音等社交APP進行分享。但這樣會存在很多問題，比如不方便批量分享、手機本地儲存空間不足等。
本賽題旨在藉助華為雲相關API，例如圖片識別能力給照片進行智慧分類，分類後通過集中儲存在雲端，使用者還可以給照片設定隱私，不分享。選手可以在API Explorer平臺檢視學習相關的雲服務API來完成賽題。最終的作品形態不限，可以是移動應用、小程式、雲服務、web、桌面應用等。
賽題解讀：釐清三步思路，用對開發工具
在解讀賽題前，先為大家科普一下華為雲的API Explorer平臺，API Explorer是為開發者提供一站式API解決方案的統一平臺，它整合華為雲服務所有開放API，支援全量快速檢索、視覺化除錯、幫助文件、程式碼示例、Mock等能力，幫助開發者快速查詢、學習API和使用API開發程式碼。目前有17大類、100+產品服務、3800+開放API。
本賽題的核心就是藉助華為雲的API能力實現應用的開發，下面我們進一步分析一下賽題說明，主要分為四個步驟：
- 將多個家庭成員的手機照片集中備份到雲端上；
- 通過圖片識別能力給照片進行智慧分類；
- 分類後通過集中儲存在雲端，可以通過大屏等終端共享給家人；
- 可以設定隱私標籤，讓圖片無法分享。
其中，我們提煉出幾個關鍵詞：圖片識別、圖片分類、圖片儲存，其實關於圖片的處理也是這幾年AI技術關注研究的重點，從這個角度看，這個賽題考查的不僅僅是API的應用，還有與計算機視覺相關的技術能力。
總結一下，參賽選手如果想要藉助API構建滿足要求的應用，可以參考下面這個思路：
- 1、通過呼叫OBS的API介面，去訪問和操作雲端儲存中的圖片資料；
- 2、通過呼叫圖片識別的API介面，對圖片進行打標籤；
- 3、通過呼叫ModelArts的API介面，對圖片進行進一步分類，並識別去除隱私圖片。
其中提及到的華為雲產品有：OBS、影象識別、ModelArts。
OBS是一款雲端儲存服務，具備標準Restful API介面，可儲存任意數量和形式的非結構化資料。
ModelArts是面向開發者的一站式 AI 開發平臺，提供海量資料預處理、智慧標註、大規模分散式訓練、自動化模型生成和端-邊-雲模型按需部署能力，幫助使用者快速建立和部署模型，管理全週期 AI 工作流。
這些產品的能力都已經“打包”成開放的API介面，選手可以在API Explorer中檢視、學習和使用。除此之外，參賽選手可以通過DevStar/DevCloud快速開發應用（APP/小程式/Web等）。
其中DevStar提供了Web、App、微服務等不同型別的80+通用框架模板，選手無需從零開始開發應用。DevCloud是一站式雲端軟體開發平臺，可隨時隨在雲端交付軟體全生命週期，覆蓋需求下發、程式碼提交、程式碼檢查、程式碼編譯、驗證、部署、釋出。
下面，我們將著重介紹此次賽題的主要產品API Explorer的使用方法以及相關案例。
API Explorer使用指南
從華為雲官網——開發者——資源工具，即可進入到API Explorer頁面，這裡包括華為雲開放的所有API資訊，選手在這個平臺上可以快速的檢視、搜尋API文件，以及視覺化除錯API，具體的關鍵能力如下圖所示。
首先是支援開放API的線上檢索和視覺化除錯，可以定位到相關雲服務，快速查詢雲服務下所有開放API。回到本次賽題，選手在API Explorer搜尋“ModeIArts”，即可在介面中看到模型部署的API文件。
通過API文件可以獲取更詳盡的資訊，包括介面約束、請求引數說明、示例、返回引數以及SDK等非常全的資訊。選擇API後，通過填寫引數，可以直接進行線上除錯，檢視API的呼叫返回結果。
如果呼叫介面返回了錯誤碼，可以在錯誤碼中心快速找到對應的錯誤詳細資訊以及處理措施建議，快速解決API調用出現的問題。
當熟悉API功能後，需要用程式碼來呼叫API，則能通過API Explorer檢視SDK程式碼示例，支援Java、Python、Go等七種主流開發語言，通過引入對應語言SDK即可快速在應用程式中呼叫API，而且所有SDK程式碼已通過GitHub開源。同時，API Explorer還提供了其他雲上/雲下CLI、API Mock、場景示例等特性，方便開發者使用。
關於API的一些應用案例，可以參考華為雲社群的雲享專題：【技術補給站】第7期：20個超實用API應用案例，開啟API進階之路（內附資料下載）。
什麼樣的作品容易拿高分？
上述提到的華為雲產品，都可以提高大家開發應用的效率，但是最終呈現的結果如何，還是要看各位選手對於技術的理解掌握，解題思路的創新，專案的完成度等等。
從大賽的評分維度來看，作品的創新性、技術實現和交付、商業性以及團隊的分工配置都非常重要。
以創新性為例，包括圖片分類演算法的準確度，API的設計呼叫等等；團隊方面，分工協作要清晰，組織架構、人員配置要合理。專案的技術路線清晰明確，技術工具成熟可靠。另外，有設計完整、可行的商業模式得到高分的可能性更大。
最後，再次提醒大家本次“網際網路+”大賽的時間安排：報名和作品提交時間截止到8月31日，初賽複賽截止9月30日，預計10月中下旬舉行全國總決賽。參賽的小夥伴們，趕快用手中的程式碼感受API的魅力吧。點選進入大賽頁面，瞭解更多資訊。