【快速玩轉華為云開發】小Hi拍了拍你，基于華為云API的開發你Get到了嗎？

初創公司R：剛剛創立，致力于通過信息化技術，幫助中小企業數字化轉型，華麗轉身。

公司成員：老板、程序猿小Hi、… …

程序猿小Hi入職公司不到三個月，就被老板單獨叫到了辦公室。小Hi心情既激動又不安，激動的是老板是不是要給自己升職加薪，不安的是不是自己表現不好，老板要炒魷魚，畢竟疫情是一個很好的借口。

來到了老板的辦公室，不等小Hi說話，就單刀直入，說：小Hi啊，你來公司挺長時間了（還沒到三個月，老板健忘？），你的工作做得挺好（心里開始爽歪歪），今天有個重要任務要交給你（涼了一半，升職加薪忘了吧）。

小Hi：好的，老板你有啥就直接吩咐，保證高效完成（心里開始有點忐忑）。

老板：昨天有個新客戶，提了個需求，他們是在XX高新區，公司多切人員雜，在目前疫情情況下，想在門崗處增加門禁，識別外來人員，加強疫情管控。這是他們的需求文檔，公司的其他人都出差了，這個任務就交給你了。記住，要做成模塊化，方便后續客戶應用。

小Hi：是，老板，我好好看看他們的需求文檔。

……

小Hi離開老板辦公室，打開需求文檔一看，六個大字映入眼簾：我們要人臉識別（不對，是七個），心里翻滾著五味雜陳，“模塊化”和“人臉識別”，這就是需求。

第一次接到了老板的任務，小Hi陷入了“深思”（吃雞游戲中…）

第一個需求是“模塊化”，模塊化就是要求封裝內部細節，精簡對外交互，實現高內聚低耦合。小Hi第一時間就想到了通過提供API來保障自身的獨立性，以及清晰化的對外交互界面，大學里學的那點API相關的知識開始在腦海里迸發：

API的定義：

應用程序接口（Application Programming Interface）是一組定義、程序及協議的集合，通過 API 接口實現計算機軟件之間的相互通信。用來提供應用程序與開發人員基于某軟件或硬件得以訪問的一組例程，而又無需訪問源碼，或理解內部工作機制的細節。

常見的API類型有：

1）RESTful API：基于HTTP、URI和XML等的常見的Web服務接口標準，描述了一個架構樣式的網絡系統，其核心是面向資源的。

2）SOAP接口：簡單對象訪問協議，簡單對象訪問協議（SOAP）是一種輕量的、簡單的、基于 XML 的協議，它被設計成在 WEB 上交換結構化的和固化的信息。

3）RPC接口：遠程過程調用 (RPC) 是一種協議，程序可使用這種協議向網絡中的另一臺計算機上的程序請求服務。

4）RMI接口：遠程方法調用RMI是針對于java語言的， RMI 允許您使用Java編寫分布式對象。

API的設計原則，好API的6個特質：

1）極簡：極簡的API是指對外暴露的盡可能少，這樣的API更易理解、記憶、調試和變更。

2）完備：完備的API是指用戶期望有的功能都包含了，滿足用戶的需求，是完備的。

3）語義清晰簡單：接口、參數、幫助等的語義清晰簡單，使用常用語和縮略語，不適用生僻語，盡量減少意外。

4）符合直覺：經驗不很豐富的用戶不用閱讀API文檔就能搞懂API，而且程序員不用了解API就能看明白使用API的代碼。

5）易于記憶：為使API易于記憶，API的命名約定應該具有一致性和精確性。使用易于識別的模式和概念，并且避免用縮寫。

6）引導API使用者寫出可讀代碼：代碼只寫一次，卻要多次的閱讀（還有調試和修改）。寫出可讀性好的代碼有時候要花費更多的時間，但對于產品的整個生命周期來說是節省了時間的。

注：源自Qt的API設計原則，詳見https://github.com/oldratlee/translations/blob/master/api-design-principles-from-qt/README.md

API相關概念

1）API網關：服務與服務之間通信的中介或橋梁，提供服務接入和鑒權、API注冊、流控、管理等API托管服務。

2）API全生命周期管理：覆蓋了API的設計、開發、測試、發布、訂閱、使用和分析的端到端、全流程的管理。

第二個需求是“人臉識別”，小Hi沒有AI相關技術積累，開始捉急，忽然靈光一閃，想起來前兩天華為云專家過來交流，有提到華為云的AI能力，于是激動的打開了瀏覽器。

輸入https://www.huaweicloud.com/，打開華為云，選擇“開發者”=>“資源工具”下的API Explorer，查看華為云所有開放API：

在API Explorer上面，可以快速查看對應云服務的開放API：

在搜索框輸入人臉識別，搜索相關的云服務：

打開人臉識別服務，有人臉比對、人臉檢測、人臉搜索、人臉資源管理、人臉庫資源管理等，挺多API的，太棒了。

迫不及待調試一把，登錄華為云（沒注冊的趕緊注冊下），選擇到人臉識別控制臺頁面（https://console.huaweicloud.com/frs/?region=cn-north-1#/frs/home），開通人臉比對服務：

在API Explorer上選擇人臉比對API（FaceCompareByFile），查看此API詳細介紹信息，包括接口說明、請求參數、示例、返回參數、錯誤碼等，此API支持對比兩張人臉圖片信息，判斷是否同一個人的置信度：

我們直接可以選擇要比對的圖片，在API Explorer上點擊調試按鈕來在線調試這個API：

點擊調試后，可以得到比對結果，相似度94.699%（代表同一個人的概率很大）：

再調試了多個API接口，查閱了人臉識別服務介紹后，小Hi心里有著落了，一張“藍圖”在腦海中繪制：

小Hi頓時信心爆棚起來，這下可以在老板面前好好表現下了。

你以為這就結束了嗎？

圖樣圖森破，小Hi還是太年輕，按以往經驗，藍圖和落地至少還差個銀河的距離，等待小Hi的是怎么快速實現這個公共服務，未完待續 ……

OpenAPI API/SDK 人臉識別服務 FRS API Explorer

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。

版權聲明：本文內容由網絡用戶投稿，版權歸原作者所有，本站不擁有其著作權，亦不承擔相應法律責任。如果您發現本站中有涉嫌抄襲或描述失實的內容，請聯系我們jiasou666@gmail.com 處理，核實后本網站將在24小時內刪除侵權內容。