API設計的一般的思路是，API提供者根據某種語法規范，表達和編寫相應的API， 然后使用對應這種語法規范的工具解析并生成指定格式的API文檔， 當然， 更進一步， API的實現代碼也可以一并生成。 生成的文檔以及代碼可以發布到版本控制系統以及相應的web站點， 然后API的使用者或者說消費者根據發布的API文檔作為參考， 使用指定的API規范訪問開放的API服務。  或者引用一下apiary的流程：  思路上稍微存在一些差異（即是否生成代碼），但先從API設計入手，然后迭代，最終發布這樣的大體流程是類似的。 當然， 圍繞著這個典型的流程， 很多解決方案可以進一步提供一些周邊的工具支持， 比如便于測試的工具， 便于版本化管理的支持， 圖形化的API編輯工具， 對應的客戶端API服務調用代碼的生成工具， 等等。