當(dāng)前，作為大部分移動app和云服務(wù)后臺之間的標(biāo)準(zhǔn)連接方式，REST API已經(jīng)得到了絕大部分開發(fā)者的認(rèn)可和廣泛的應(yīng)用。近年來，在新興API經(jīng)濟(jì)模式逐漸興起，許多廠商紛紛將自己的后臺業(yè)務(wù)能力作為REST API開放出來，給更廣泛的第三方開發(fā)者使用。
但是，管理REST API并非是一件容易的工作。由于缺乏有效的接口數(shù)據(jù)schema約束，加上設(shè)計REST API時resource endpoint的安排，以及發(fā)送http請求的方式又都五花八門，REST API開發(fā)完成后，大多數(shù)情況下API開發(fā)者仍然需要手動書寫API文檔，讓用戶能按照文檔的說明接入。并且在API發(fā)生變化時需要重寫文檔，這個過程費(fèi)時費(fèi)力而且容易出錯。比如，一個REST API文檔最少必須列明以下的基本信息：
* API的名稱
* API所在的URL資源路徑
延伸閱讀
- ssh框架 2016-09-30
- 阿里移動安全 [無線安全]玩轉(zhuǎn)無線電——不安全的藍(lán)牙鎖 2017-07-26
- 消息隊(duì)列NetMQ 原理分析4-Socket、Session、Option和Pipe 2024-03-26
- Selective Search for Object Recognition 論文筆記【圖片目標(biāo)分割】 2017-07-26
- 詞向量-LRWE模型-更好地識別反義詞同義詞 2017-07-26
- 從棧不平衡問題 理解 calling convention 2017-07-26
- php imagemagick 處理 圖片剪切、壓縮、合并、插入文本、背景色透明 2017-07-26
- Swift實(shí)現(xiàn)JSON轉(zhuǎn)Model - HandyJSON使用講解 2017-07-26
- 阿里移動安全 Android端惡意鎖屏勒索應(yīng)用分析 2017-07-26
- 集合結(jié)合數(shù)據(jù)結(jié)構(gòu)來看看(二) 2017-07-26
學(xué)習(xí)是年輕人改變自己的最好方式