三個工具協助你打造出更好的 API

前一篇文章中提到為何越來越多的公司考慮 API 先行和開放 API 的商業策略,撇除了部分以 API 為產品或服務的公司之外,有更多的公司是在產品或服務達到一定規模之後,才考慮透過 API 來擴展公司盈利的管道,畢竟沒人使用的產品或平台,有再好的 API 也是枉然。當然除了開放的 API 外,有很大的部分是企業內部的私有 API,在每個開發者的開發生涯中,或多或少都會有自行開發 API 的需求和經驗。以下介紹三個工具和服務,類型含括了設計,開發(測試),和監控,透過這些工具和服務來協助你或你的團隊,開發出更好的 API。

1. Apiary.io

apiary.io

如同 Apiray 官網首頁所寫的,”API Design is Hard”,API 的設計牽涉層面極廣,從產品經理,技術人員,甚至到合作客戶都極可能影響 API 的設計。Arpiray 是一個線上的 API 設計協作平台,讓你透過 Markdown 語法來定義你的 API,完成之後即可馬上轉成線上文件和其他人協作,或是針對設計進行留言和討論。Apiary 也提供了各種程式語言範例,讓開發者能夠快速測試。而在過去開發流程中,當 API 設計完成後,往往需要等待 API 實作完成,才有辦法提供手機或其他應用程式來進行測試。透過 Apiary 提供的 Mock Server,可以將你定義好的 API 可直接轉成可供測試的 API 服務,讓 API 的使用者或呼叫方可以在 API 實作完成之前就先行測試,對於整體開發的流程和效率有很大的改善。

2. Postman

postman
在 API 開發的過程中,必需不斷地重複呼叫來進行測試,這是相當耗時且瑣碎的工作,Postman 讓你可以先定義每個 API 呼叫,支援包含 GET,POST,PUT,DELETE 等多種 HTTP Method, 以及客制化 HTTP Header 內容等功能,在需要時即可一鍵送出。另外還可以針對不同環境 (Development / Testing / Production) 來建立不同的 API 呼叫,讓你在開發的過程中,可以快速針對不同環境來進行測試。嫌手動測試太麻煩了嗎?Postman 還提供了command line tool,方便讓你執行自動化測試。使用 Postman 絕對可以大幅減輕 API 開發過程中瑣碎的測試工作,加速整體開發的生命週期。

3. Runscope

runscope
監控應用程式時,可以使用 New Relic 來監控效能,那麼當 API 開發完成了, 部署至測試環境或是正式環境時該如何監控? Runscope 提供了簡易的管理和監控介面,讓你監控每個 API 的連線狀況,流量和效能,並在 API 出錯時立即通知你的開發團隊。

如同 Runscope 官網所寫的 “Everything should be 200 ok”, 當你的產品服務達到一定規模時,任何的 API 呼叫錯誤,都會對公司和 API 使用者造成極大的影響。好的監控工具,絕對是你的產品或平台所不可或缺的。

以上,僅簡述筆者曾經使用且對整體開發流程有大幅改善的工具,事實上還有許多值得你去嘗試的 API 開發測試工具或 Framework,如 Swagger 、RAMLStrongloop 等。善用這些工具,將有效協助你的公司或開發團隊,打造出更佳的 API,創造出更優秀的產品或平台。

你也是 API 開發者嗎?歡迎在底下留言跟大家分享你常使用的 API 開發或測試工具!

About 王昱程

Freelance Web Developer / 督視人平台創辦與開發者,曾參與柯P公民顧問團網站製作與營運。目前專注於 WordPress 與 Restful API 設計 ,期望透過程式讓這個社會變得更美好。 Let's write some CODE!
募資前你必須要知道的生產重點
【史丹佛 2015 iOS 課程筆記】1.打造計算機 App,Storyboard 和 Swift 初體驗