API設計：Swagger, Blueprint和RAML

Swagger Swagger與RAML相比，RAML解決的問題是設計階段的問題，而Swagger則是側重解決現有API的文檔問題，它們最大的不一樣是RAML須要單獨維護一套文檔，而Swagger則是經過一套反射機制從代碼中生成文檔，而且藉助ajax能夠直接在文檔中對API進行交互。由於代碼與文檔是捆綁的因此在迭代代碼的時候，就能方便的將文檔也更新了。不會出現隨着項目推移代碼與文檔不匹配的問題。另

>>阅读原文<<