當前，作為大部分移動app和云服務后臺之間的標準連接方式，REST API已經(jīng)得到了絕大部分開發(fā)者的認可和廣泛的應用。近年來，在新興API經(jīng)濟模式逐漸興起，許多廠商紛紛將自己的后臺業(yè)務能力作為REST API開放出來，給更廣泛的第三方開發(fā)者使用。
但是，管理REST API并非是一件容易的工作。由于缺乏有效的接口數(shù)據(jù)schema約束，加上設計REST API時resource endpoint的安排，以及發(fā)送http請求的方式又都五花八門，REST API開發(fā)完成后，大多數(shù)情況下API開發(fā)者仍然需要手動書寫API文檔，讓用戶能按照文檔的說明接入。并且在API發(fā)生變化時需要重寫文檔，這個過程費時費力而且容易出錯。比如，一個REST API文檔最少必須列明以下的基本信息：
* API的名稱
* API所在的URL資源路徑
