API的一些基礎知識
適讀對象為無代碼基礎的讀者，本文結閤工作流中的發送API請求，簡單介紹API接口的一些基礎知識。
什麼是API
API（Application Programming Interface，應用程序接口），是軟件開發者將某個做好功能開放給外部人員使用的一個窗口。外部人員無需訪問源碼或理解內部代碼處理細節，隻需要按API規定的格式傳遞一些參數，即可獲取期望的數據或執行期望的操作。
例如一個典型的API接口服務：查詢手機號的歸屬地。
http://apis.juhe.cn/mobile/get?key=4c80e35a4220b955a2932a38e6511e9e&phone=15838082573
點開此鏈接打開頁麵，查詢的15838082573的歸屬地，您隻需修改地址欄中【phone=】後麵的手機號，按迴車，即可查詢另一個手機號的歸屬地。
這就是API服務，您隻需在請求時給服務器傳遞參數，無需理會如何實現，即可獲取到期望的內容。
API請求的組成
什麼是請求，API接口的調用，是通過一個URL地址傳輸的，URL打開一次就是一次請求，刷新頁麵，又算一次請求。
請求API接口，其實就是打開訪問接口的URL，此URL在請求時需要幾個組成部分：
API接口地址
即API接口服務公開給外部訪問的地址
請求方式
常用的有Get 、Post 和其他方式，這取決於API接口服務，無需理解，他們支持什麼，我們選擇對應的方式即可。
請求的參數
API接口根據你傳遞的參數處理對應的數據。例如，URL中的phone就是一個參數
授權認證方式
在請求API時，不是誰請求都會處理，需要對您的請求做認證。常見的是 token 認證和key(有時還有會結閤sign)。這些信息API服務商都會給到您。
Header
請求過程中需要傳遞的錶頭信息，是係統級的參數，包含存儲認證信息Token的參數。一般情況下我們不需要配置，需要配置時，API文檔中會特彆說明。
Body
同樣也是存儲傳遞的數據，它在請求方式為Post時纔需要配置。常用來存儲錶單信息，有時授權認證的參數也可以存儲在這裏。
例如，通過API接口，將一個錶單數據新增到第三方係統，錶單的字段名稱和字段值存放在Body中。
總體來說：調用API 接口時，需要三部分：
- 請求的API URL地址
- 傳遞的參數
- 授權身份認證
圖文舉例
舉例1：查詢手機號歸屬地 （Get 方式）
接口服務商：聚閤數據
API地址： http://apis.juhe.cn/mobile/get
請求方式： Get
傳遞的參數： phone(手機號)、key（服務商分配的身份認證碼）
授權認證方式： 通過申請的key來驗證身份。這種認證方式可以將Key拼接在URL中，通過一個URL即可完成請求。
Header： 沒特彆說明，無需配置
Body： Get方式 無需配置
將請求地址和參數進行拼接，得到請求的完整URL（參數間用&鏈接，第一個參數前麵加？）
http://apis.juhe.cn/mobile/get?key=4c80e35a4220b955a2932a38e6511e9e&phone=15838082573
以下是API返迴的數據（JSON格式），彆擔心看不懂，係統可以接收並處理好這些數據。
在工作流中的的配置如下，每個節點作用：
- 觸發節點：當一個聯係人的手機號填寫或修改時，觸發流程，
- 發送API請求節點：根據手機號請求API，獲取到此手機號的歸屬地，
- 更新記錄節點：將歸屬地信息更新到聯係人記錄中。
舉例2：獲取企業的工商信息（Get 方式）
接口服務商：天眼查
API地址： http://open.api.tianyancha.com/services/open/ic/baseinfo/2.0
請求方式： Get
傳遞的參數： id 或 name (因為說明中寫瞭，隻輸入一個即可，不然需要全部傳遞)
授權認證方式：token認證，但需要通過header傳遞。
首先，我們拼接好完整的請求URL
http://open.api.tianyancha.com/services/open/ic/baseinfo/2.0?name=平安銀行股份有限公司
Header配置
由於此接口的授權認證方式，為Token認證，且需要將Token的值 通過header傳遞，因此不能僅通過一個URL就能調用API。需要配置Header
隻要是通過header 傳遞 Token，則header中的字段名都是Authorization，此字段專門用來存放認證信息的。
在工作流中的Webhook的配置如下，將拼接的請求URL和Header 分彆配置到 Webhook URL 和Header 中。
每個節點的作用：
- 觸發節點：當客戶記錄的 公司全稱填寫或修改時，觸發流程
- 發送API請求節點：調用API接口獲取到此企業的基本信息
- 更新記錄節點：將獲取的信息更新到客戶記錄中
舉例3：通過API嚮工作錶中新增一行記錄 （Post 方式）
我們就以工作錶API為例，介紹如何嚮錶中新增一行記錄。
首先來看下工作錶API
從API介紹中可以看到， 請求的方式是 Post，隻需配置 請求URL 和 參數即可。
授權認證方式為 appkey + sign , 和參數一起，配置在Body中即可。
Body 中 支持兩種參數提交格式
Key-value pairs :簡單說，就像圖中配置那樣，左邊是參數名，右邊是參數的值。
Raw(application/json) : 是將參數和參數值 轉化為 Json格式傳遞，一般需要程序員配置處理
在工作流中的 Webhook的配置如下，將請求的URL和參數 分彆配置到 Webhook URL 和Body中。
每個節點的作用：
- 觸發節點：當《公開報名錶》有新記錄錄入時
- 發送API請求節點：通過《人員登記錶》的API，嚮此錶發送新增數據，直接新增一條記錄。
文檔問題反饋
文檔中是否有錯彆字、內容過期、難以理解等問題？ 點此給我們反饋吧