作為一名又拍雲的技術支援工程師，小拍每天都會接收到很多客戶的提問。這其中，有很多客戶會問：“小拍，請問雲端儲存上傳除了使用控制檯的檔案管理和 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 上傳介面呀。
