白话科普，10s 了解 API
作為一名又拍云的技術支持工程師，小拍每天都會接收到很多客戶的提問。這其中，有很多客戶會問：“小拍，請問云存儲上傳除了使用控制臺的文件管理和 FTP 工具之外，有沒有其他的途徑進行上傳呢？”
“有噠，您可以調用 API 接口來進行上傳哦。”
“請問，什么是 API 接口呢？我要怎么調用呢？”
別著急，這就為您介紹 API 接口。
什么是 API 接口
首先，我們先來看一看 API 接口的定義：
API（Application Programming Interface,應用程序編程接口）是一些預先定義的函數，目的是提供應用程序與開發人員基于某軟件或硬件得以訪問一組例程的能力，而又無需訪問源碼，或理解內部工作機制的細節。
從定義中，我們先劃下重點：函數、 提供應用程序與開發人員、無需訪問源碼、例程 。其中，例程是某個系統對外提供的功能接口或服務的集合。
看完這個定義是不是感覺自己看了個寂寞，這解釋跟不解釋沒有差別啊？好啦，不要擔心，小拍來給大家直接了當的說一說。
API 其實可以理解為是接收要求的信差，通過 API 接口，我們告訴系統（例程）想要做什么，系統再把處理結果響應回來。
如果用一個現實生活中的場景來舉例說明，那么餐廳的服務員其實就是一個典型的 API 。想象一下你正坐在餐桌前，面前桌子上有一張點菜用的菜單，點好菜后，交由廚房進行處理。但現在少了一個關鍵的鏈接點，如何把我們的單子送到廚房，再把食物送到我的桌上呢？
這就是服務員（API）登場的時候了。服務員就是這個信差，他會傳遞你的要求或者餐點，把這些信息告訴廚房（系統），廚房就會知道怎么做，然后把餐品通過服務員端（響應）給你。
現在我們把這個原理應用到真正的 API 例子上來。
快遞單號查詢，這大家應該很熟悉吧。朋友通過順豐寄了一箱零食給你，并告知你了快遞單號，你就可以在順豐的官網上，輸入快遞單號進行查詢。順豐的系統接收到查詢，就會在系統中查找對應快遞的信息，響應給你。
但是，很多時候我們并不是直接通過快遞公司的網站去查詢快遞信息的。比方說通過淘寶買的衣服，賣家通過順豐發貨，但我們可以在淘寶上查詢到順豐快遞的信息。那么淘寶是怎么獲取到存放在順豐服務器上的快遞數據呢？
沒錯，這里就是使用了 API 。淘寶可以通過順豐提供的 API 接口，來獲取存放在順豐服務器上的快遞信息，最后顯示在我們面前。
現在再看上邊的定義，是不是感覺好理解一些了呢？API 接口就是預先定義好的函數邏輯，提供給其他系統請求，然后返回結果的一個東西。
為什么要使用 API 接口
在知道了 API 接口的作用后，使用 API 接口的原因也就一目了然了。舉個例子：你打算開發一個打車軟件，需要在頁面上展現地圖，那你會怎么做呢？
如果說自己來開發地圖，開發時間就會大大延長，成本也會增加許多。這個時候，其實可以在高德開放平臺或者百度地圖的開放平臺，找到地圖 API，購買他們的服務，部署調用相關的 API ，這樣就可以快速在我們軟件中上線地圖功能了。
所以，對于軟件提供商來說，開放 API 并讓別的應用程序來調用，形成生態，軟件才能發揮最大的價值，才能更有生命力，同時別人也看不見代碼，不會傷害商業機密。
對于應用開發者來說，有了開放的 API ，就可以直接調用多家公司做好的功能來做自己的應用，不需要所有的事情都自己操刀，節省精力。
如何使用 API 接口
現在市面上開放的 API 接口，一般都是通過 HTTP 請求調用的。例如，一些第三方提供的查詢天氣的功能，我們就可以根據第三方提供的 API 地址以及相關的說明文檔，攜帶上請求參數，在瀏覽器中直接訪問使用。
接下來，小拍以又拍云存儲上傳 API 為例，通過 curl 工具來完成一個向云存儲上傳文件的操作。接下來會涉及到一些命令行工具以及代碼的操作，如果你對 curl 這個工具不太熟悉的話，也可以參考小拍之前的文章《雙劍合璧-掌握 curl 和 Dig 走天涯》哦。
每個 API 接口根據作用不同，需要傳遞的參數也是不盡相同的。因此，我們在使用一個 API 接口之前，最好先看一下官方文檔的 API 說明。
通過文檔介紹，我們可以看到如果需要請求云存儲的上傳接口，我們需要使用 PUT 的方式，向 http://v0.api.upyun.com 發起請求。其中存儲服務名和文件的保存路徑定義在請求地址中。并且需要攜帶 Authorization 鑒權請求頭，來確保 API 的調用是合法的。
Authorization 的生成，小拍使用最簡單的基本認證來進行演示。
根據鑒權文檔介紹，curl 支持直接傳入操作員名和密碼來生成鑒權請求頭。
了解 API 接口調用的規則之后，我們就可以開始準備數據，來向云存儲空間上傳文件啦。
例如，小拍的桌面上有一張圖片，小拍想把圖片上傳到自己云存儲空間下的 images 目錄下，保存名為 lufei.jpg。
小拍的云存儲空間名為 fileupload-upyun，操作員名為 hello，對應的密碼為 dF4XhRbnpsvonU1dgdetURncHSwa2Z37，這樣，我們就有調用上傳 API 的必要參數了。
接下來，我們就按照要求，組裝 curl 的請求命令。
curl -X PUT \ http://v0.api.upyun.com/fileupload-upyun/api/lufei.jpg \ -u hello:dF4XhRbnpsvonU1dgdetURncHSwa2Z37 \ -T C:\Users\hilih\Desktop\test.jpg參數說明：
-X 可以指定 curl 發起請求的方法
-u 對傳入的數據進行 HTTP 基本認證，也就是用戶和密碼組和的base64編碼
-T 可以使 curl 讀取指定路徑下的文件
這樣呢，我們就成功的調用了云存儲的上傳 API 接口，通過接口上傳了一張本地的圖片到存儲空間中。
不過，使用 curl 發起 HTTP 請求，看上去總有一些麻煩，命令行也太反人類了吧，有沒有更加友好的界面呢？當時啦，使用 curl 只是其中一種的上傳方法，我們還可以通過其它方式，來向云存儲 API 發起 HTTP 請求。
例如二狗子的網站分享圖片，二狗子就對上傳的 API 做了處理，用網頁的形式對他的用戶提供了一個上傳的 API 接口。小拍也聯系了二狗子，請他提供了一個簡單的測試用例。
<!DOCTYPE html> <html> <head> <meta charset="utf-8"> <title>云存儲上傳</title> <script src="https://cdn.bootcdn.net/ajax/libs/axios/0.20.0/axios.min.js"></script> </head> <body> 上傳服務空間：<input id='bucketname'> 操作員賬號：<input id='username'> 操作員密碼：<input id='password'> 存儲路徑：<input id='path'> 文件選擇：<input id='fileupload' type='file' name='file' /><br><br> <button>上傳</button> <script type="text/javascript"> window.onload = function() { document.querySelector('button').onclick = ufload; } function ufload() { var bucket = document.querySelector('#bucketname').value; var username = document.querySelector('#username').value; var password = document.querySelector('#password').value; var path = document.querySelector('#path').value; var input = document.querySelector('#fileupload'); var file = input.files[0]; axios.defaults.baseURL = 'http://v0.api.upyun.com'; axios.put('/' + bucket + path, file, { auth: { username: username, password: password } }).then(function(response) { console.log(response.data); console.log(response.headers); console.log(response.status); if (response.status == 200) { alert('上傳成功'); } }) } </script> </body> </html>也歡迎你使用熟悉的編程語言，來嘗試調用 API 上傳接口呀。
超強干貨來襲 云風專訪：近40年碼齡，通宵達旦的技術人生總結
以上是生活随笔為你收集整理的白话科普，10s 了解 API的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 技术选型：为什么批处理我们却选择了Fli
- 下一篇： 白话科普系列——双十一，竟然是一场有“预